# txpool_status - Manta RPC Method

Returns transaction pool counters for the connected Manta Pacific endpoint. The result separates transactions that are immediately processable (`pending`) from those waiting on an earlier nonce or other prerequisite (`queued`).

> **Non-standard method.** `txpool_status` is a Geth-style mempool inspection method. It is not part of the core Ethereum Execution API method set, and many shared RPC endpoints disable it.

> **Why Manta?** Build on the modular ZK L2 with Celestia DA delivering the lowest fees for 200+ dApps with first L2 on Celestia mainnet, ZK-as-a-Service via Universal Circuits, Polygon CDK integration, and modular OP Stack architecture.

## When to Use This Method

`txpool_status` is valuable for ZK application developers, privacy-focused builders, and teams requiring modular scalability:

- **Mempool Monitoring** - Watch pending versus queued pressure on a node
- **Congestion Signals** - Detect bursts of transaction backlog before they show up in block-level metrics
- **Node Health Checks** - Confirm a node is accepting and classifying new transactions as expected
- **Operational Dashboards** - Surface lightweight txpool counters without pulling full transaction content

## Best Practices

- Returns pending and queued transaction counts; high pending counts suggest network congestion
- Combine with eth\_gasPrice for informed transaction submission timing decisions
- This is a non-standard method; many shared endpoints disable txpool access
- Use as a lightweight alternative to txpool\_content when you only need aggregate counts

## Request Parameters

This method accepts no parameters.

## Request Example

```json
{
  "jsonrpc": "2.0",
  "method": "txpool_status",
  "params": [],
  "id": 1
}
```

## Response Fields

- `pending` (`QUANTITY, required`): Number of processable transactions currently in the pool
- `queued` (`QUANTITY, required`): Number of transactions waiting on an earlier prerequisite such as nonce order

## Successful Response

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "pending": "0xbaf3",
    "queued": "0x1b6"
  }
}
```

## Error Responses

### Error Response

- Code: `-32601`

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Method not found"
  }
}
```

## Code Examples

cURL
JavaScript
Python
Go

```bash
curl -X POST https://api-manta-pacific-archive.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "txpool_status",
    "params": [],
    "id": 1
  }'
```

```javascript
import { JsonRpcProvider } from 'ethers';

const provider = new JsonRpcProvider('https://api-manta-pacific-archive.n.dwellir.com/YOUR_API_KEY');

const txpool = await provider.send('txpool_status', []);

console.log('Pending:', parseInt(txpool.pending, 16));
console.log('Queued:', parseInt(txpool.queued, 16));
```

```python
import requests

response = requests.post(
    'https://api-manta-pacific-archive.n.dwellir.com/YOUR_API_KEY',
    json={
        'jsonrpc': '2.0',
        'method': 'txpool_status',
        'params': [],
        'id': 1,
    },
)

txpool = response.json()['result']
print('Pending:', int(txpool['pending'], 16))
print('Queued:', int(txpool['queued'], 16))
```

```go
package main

import (
    "context"
    "fmt"
    "log"

    "github.com/ethereum/go-ethereum/rpc"
)

func main() {
    client, err := rpc.Dial("https://api-manta-pacific-archive.n.dwellir.com/YOUR_API_KEY")
    if err != nil {
        log.Fatal(err)
    }

    var status map[string]string
    err = client.CallContext(context.Background(), &status, "txpool_status")
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Pending: %s\n", status["pending"])
    fmt.Printf("Queued: %s\n", status["queued"])
}
```

## Related Methods

- [`txpool_content`](https://www.dwellir.com/docs/manta-pacific/txpool_content) - Inspect the full pending and queued transaction maps
- [`eth_blockNumber`](https://www.dwellir.com/docs/manta-pacific/eth_blockNumber) - Track block production alongside mempool pressure
- [`eth_gasPrice`](https://www.dwellir.com/docs/manta-pacific/eth_gasPrice) - Compare congestion signals with fee estimates