[strands-agents-spraay](https://github.com/plagtech/strands-agents-spraay) is a batch payment tool for Strands Agents, powered by the [Spraay Protocol](https://spraay.app). Send ETH or ERC-20 tokens to up to 200 recipients in a single transaction on Base with ~80% gas savings.

## Installation

```bash
pip install strands-agents-spraay
```

## Usage

```python
from strands import Agent
from strands_spraay import spraay_batch_payment

agent = Agent(tools=[spraay_batch_payment])

# Send equal ETH to multiple recipients
agent("Send 0.01 ETH to 0xAAA..., 0xBBB..., and 0xCCC... using batch payment")
```

## Key Features

-   **Batch ETH**: Send equal or variable ETH amounts to multiple recipients
-   **Batch ERC-20**: Send equal or variable token amounts with automatic approval handling
-   **Up to 200 recipients**: Per transaction with ~80% gas savings
-   **Chain ID verification**: Prevents sending to wrong network
-   **Gas buffer**: 10% buffer on estimates to prevent out-of-gas errors

## Configuration

```bash
SPRAAY_PRIVATE_KEY=your_wallet_private_key    # Required
PRIVATE_KEY=your_wallet_private_key            # Alternative
BASE_RPC_URL=https://mainnet.base.org         # Optional
```

> ⚠️ **Security**: Never commit your private key to source control. Use environment variables or a secrets manager.

## Resources

-   [PyPI Package](https://pypi.org/project/strands-agents-spraay/)
-   [GitHub Repository](https://github.com/plagtech/strands-agents-spraay)
-   [Spraay Protocol](https://spraay.app)