Monitor Account

Summary

DA Builder account monitoring uses dab_accountInfo for GasTank balances and eth_getTransactionReceipt or dab_transactionStatus for request tracking.

Account Information

dab_accountInfo returns the current GasTank balance and outstanding charges for an account.

Response field	Meaning
`balance`	GasTank balance in wei
`outstanding_charge`	Charges pending settlement in wei

Authenticated cURL Request

curl -s https://da-builder.mainnet.spire.dev/ \
  -H "Content-Type: application/json" \
  -H "X-Flashbots-Signature: 0xYOUR_ADDRESS:0xYOUR_SIGNATURE" \
  --data '{
    "jsonrpc": "2.0",
    "method": "dab_accountInfo",
    "params": ["0xYOUR_ACCOUNT_ADDRESS"],
    "id": 1
  }'

Example response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "balance": "1000000000000000000",
    "outstanding_charge": "50000000000000000"
  }
}

Authentication Header

The X-Flashbots-Signature header format is:

X-Flashbots-Signature: <address>:<signature>

The signature is an EIP-191 signature of the JSON-RPC request body hash.

TypeScript: Account Info With ethers v6

import { Wallet, getBytes, id } from "ethers";

const rpcUrl = "https://da-builder.mainnet.spire.dev/";

async function accountInfo(privateKey: string, account: string) {
  const wallet = new Wallet(privateKey);
  const body = JSON.stringify({
    jsonrpc: "2.0",
    method: "dab_accountInfo",
    params: [account],
    id: 1
  });

  const signature = await wallet.signMessage(getBytes(id(body)));

  const response = await fetch(rpcUrl, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Flashbots-Signature": `${wallet.address.toLowerCase()}:${signature}`
    },
    body
  });

  const json = await response.json();
  if (json.error) throw new Error(`${json.error.code}: ${json.error.message}`);
  return json.result as { balance: string; outstanding_charge: string };
}

Recommended Monitoring Workflow

Check GasTank balance before submitting transactions.
Submit through DA Builder and store the transaction hash.
Poll eth_getTransactionReceipt with bounded retries.
Use dab_transactionStatus for richer cost and status data.
Alert when GasTank balance minus outstanding_charge falls below your operating threshold.

Troubleshooting

Symptom	Likely cause	Recommended action
`Account not found`	GasTank is not funded or deposit is not indexed	Deposit ETH and retry after a couple minutes
`Insufficient balance.`	GasTank cannot cover expected cost	Add ETH to GasTank or use direct RPC fallback if the EOA has enough ETH
Receipt returns `null`	Request has not landed yet	Continue polling with backoff
`Transaction not found`	Transaction hash is wrong or not yet indexed	Verify the transaction hash and retry
Auth failure	Header signature does not match request body	Recreate the JSON body string and sign that exact body

FAQ

What is the best way to monitor DA Builder in production?

Monitor GasTank balance with dab_accountInfo, store every transaction hash, poll receipts with bounded retries, and keep direct RPC fallback.

Should monitoring code use DA Builder for all Ethereum reads?

No. Use DA Builder for documented monitoring methods. Use a standard Ethereum RPC provider for general Ethereum reads.

Next Steps

Quick Reference - Method signatures and examples.
Cost Structure - Understand balances and charges.
Full Integration Guide - Add production fallback.

​Summary

​Account Information

​Authenticated cURL Request

​Authentication Header

​TypeScript: Account Info With ethers v6

​Recommended Monitoring Workflow

​Troubleshooting

​FAQ

​What is the best way to monitor DA Builder in production?

​Should monitoring code use DA Builder for all Ethereum reads?

​Next Steps