# Pre-Sign Transaction Simulation

> Pre-Sign Transaction Simulation is a paid API for AI agents from agentforge-taupe.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-16).

Simulates EVM transactions before signing to detect reverts, asset changes, approvals, sanctions, and scam risks with a proceed/caution/avoid verdict

## Facts

- Endpoint: GET https://agentforge-taupe.vercel.app/v1/tx-simulate?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pre-sign-transaction-simulation-38540e6d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Flw3pVyDWsm0UHJmQki86

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pre-sign-transaction-simulation-38540e6d
```

Example prompt: Before I sign this transaction, simulate it on Base for my wallet 0xAbCd…1234 — check whether it reverts, what assets will leave or enter my wallet, any approvals it grants, and whether any counterparty is sanctioned or a known scammer, then give me a verdict on whether I should proceed.

## When to prefer this

Use this endpoint when an AI agent needs to verify the safety of one or more EVM transactions before the user signs — especially for DeFi interactions, token approvals, swaps, or airdrop claims. It is preferred over a simple revert checker because it also screens counterparties for OFAC sanctions and known scam addresses, enumerates all asset flows, and returns a human-readable verdict. Choose it over a generic balance check or approval scanner when you need a holistic pre-sign safety verdict covering up to 5 chained transactions across Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Linea, Unichain, or Sonic.

## Known failure modes

- Invalid wallet address format returns a 400 validation error
- Unsupported chain name returns an enum validation error
- Transaction array with more than 5 items is rejected
- Malformed calldata or hex values may cause simulation failure
- Network congestion on the target chain may cause timeout
- Unverified or self-destructed contracts may produce incomplete simulation results
- Missing required 'to' field in a transaction object returns a 400 error

## How this service works

Transaction simulation before signing (pre-sign safety check and drainer detection): simulate an EVM transaction or an approve-then-swap sequence of up to 5 — revert check with reason, every asset leaving or entering the wallet, approvals granted, sanctions/scam screening of every counterparty, and a proceed/caution/avoid verdict. Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Linea, Unichain, Sonic. Category: security.

## Output

Returns a JSON object with a top-level verdict (proceed, caution, or avoid), a list of reasons explaining the verdict, an array of asset changes (tokens entering or leaving the wallet), approvals granted by the transaction, and a list of counterparties with their addresses, roles, and individual verdicts including sanctions or scam flags. Revert reasons are included when applicable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "from": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Wallet that will sign"
  },
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "arbitrum",
    "optimism",
    "polygon",
    "bsc",
    "linea",
    "unichain",
    "sonic"
   ],
   "type": "string",
   "default": "base"
  },
  "transactions": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "to"
    ],
    "properties": {
     "to": {
      "type": "string"
     },
     "gas": {
      "type": "string"
     },
     "data": {
      "type": "string",
      "default": "0x"
     },
     "value": {
      "type": "string",
      "default": "0x0",
      "description": "Wei, hex or decimal"
     }
    }
   },
   "maxItems": 5,
   "minItems": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "reasons": [
   "Transaction 1 reverts: Blacklistable: account is blacklisted",
   "recipient 0x0330… is on a sanctions or scam list"
  ],
  "verdict": "avoid",
  "approvals": [],
  "assetChanges": [],
  "counterparties": [
   {
    "role": "recipient",
    "address": "0x0330…",
    "verdict": "block"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pre-sign-transaction-simulation-38540e6d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentforge-taupe.vercel.app](https://www.zero.xyz/host/agentforge-taupe.vercel.app/llms.txt)
