base_transactionStatus

Checks whether a transaction exists in the Base mempool. Returns "Known" if the transaction is pending in the mempool, or "Unknown" if it is not found (either already included in a block or never submitted).

This method is part of the base_ namespace introduced with Flashblocks support.

Availability

Currently available on Base Mainnet only.

Use Cases

• Transaction tracking — Check if a submitted transaction is still pending
• Mempool monitoring — Verify transaction propagation
• Retry logic — Determine whether to resubmit a transaction

Parameters

Parameter	Type	Required	Description
transactionHash	DATA	Yes	32-byte transaction hash to look up

Request

{
  "jsonrpc": "2.0",
  "method": "base_transactionStatus",
  "params": ["0x..."],
  "id": 1
}

Returns

Field	Type	Description
status	String	"Known" if the transaction is in the mempool, "Unknown" otherwise

Code Examples

cURL

curl -X POST https://api-base-mainnet-archive.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "base_transactionStatus",
    "params": ["0x5c884a466fb59ee69114a0c99cb15d4d8af670a37be53fd59ffda3b5566b4269"],
    "id": 1
  }'

JavaScript

const response = await fetch(
  'https://api-base-mainnet-archive.n.dwellir.com/YOUR_API_KEY',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      method: 'base_transactionStatus',
      params: ['0x5c884a466fb59ee69114a0c99cb15d4d8af670a37be53fd59ffda3b5566b4269'],
      id: 1,
    }),
  }
);

const data = await response.json();
console.log('Transaction status:', data.result.status);
// "Known" = in mempool, "Unknown" = not in mempool

Python

import requests

response = requests.post(
    'https://api-base-mainnet-archive.n.dwellir.com/YOUR_API_KEY',
    json={
        'jsonrpc': '2.0',
        'method': 'base_transactionStatus',
        'params': ['0x5c884a466fb59ee69114a0c99cb15d4d8af670a37be53fd59ffda3b5566b4269'],
        'id': 1
    }
)

result = response.json()['result']
print(f"Status: {result['status']}")

Response Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": "Unknown"
  }
}

Error Handling

Error Code	Message	Description
-32602	Invalid params	Invalid transaction hash format

Related Methods

• eth_getTransactionByHash — Get full transaction details
• eth_getTransactionReceipt — Get transaction receipt
• eth_sendRawTransactionSync — Send transaction with synchronous confirmation

---

Need help? Contact our support team or check the Base documentation.