# API Reference

## API Reference

### Process Transaction

Simulates and analyzes a submitted transaction, comparing the actual execution with the provided **reason (intent)** — what the transaction is expected to do.

Based on the analysis, the system determines whether the transaction should be **approved** or **rejected**, and flags any **risks or mismatches** with the original intent

**Base URL**

```
http://apib.baibysitter.xyz
```

**Endpoint**

```
POST /api/transaction
```

**Swagger**

```
http://apib.baibysitter.xyz/docs#tag/default/post/api/transaction
```

***

#### Request

**Headers**

```http
Content-Type: application/json
```

**Body Parameters**

| Field          | Type    | Required           | Description                                                         |
| -------------- | ------- | ------------------ | ------------------------------------------------------------------- |
| `chainId`      | Integer | ✅ Yes              | Blockchain network ID                                               |
| `from_address` | String  | ✅ Yes              | Sender wallet address                                               |
| `to_address`   | String  | ✅ Yes              | Recipient wallet address                                            |
| `data`         | String  | ✅ Yes              | Encoded transaction data                                            |
| `value`        | String  | No (default `"0"`) | ETH or native token value sent                                      |
| `reason`       | String  | Optional           | Declared intent for the transaction (e.g., `"swap 1 ETH for USDC"`) |

***

#### Example Request

**Shell / cURL**

```bash
curl http://apib.baibysitter.xyz/api/transaction   --request POST   --header 'Content-Type: application/json'   --data '{
    "chainId": 8453,
    "from_address": "0x2af7BA938d51353A5eE998cDB770e006C57b252B",
    "to_address": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b",
    "data": "0xa9059cbb0000000000000000000000007357ad9f66b6e4e056f8f4a469844f4fab00f1440000000000000000000000000000000000000000000000007ce66c50e2840000",
    "value": "0",
    "reason": "i want to transfer 9 virtuals to 0x7357ad9F66B6E4e056F8f4a469844F4faB00F145"
  }'
```

***

#### Responses

**200 OK**

```json
{
  "transaction_id": "497da974-7e74-461e-a85d-40b469ef6d1f",
  "validations": {
    "agent": {
      "risks_detected": [
        "Intent mismatch between Primary Reason and simulated behavior"
      ],
      "status": "rejected",
      "message": "The transaction is rejected due to a mismatch in recipient addresses between the Primary Reason and sentinel information. Expected recipient 0x7357ad9F66B6E4e056F8f4a469844F4faB00F145 but found 0x7357ad9f66b6e4e056f8f4a469844f4fab00f144. This could indicate a potential risk of funds being sent to an unintended recipient.",
      "warnings_considered": []
    }
  },
  "created_at": "2025-09-17T01:45:55.700394",
  "updated_at": "2025-09-17T01:46:08.676536",
  "status": "completed"
}
```

**422 Validation Error**

```json
{
  "detail": [
    {
      "loc": ["body", "chainId"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}
```

***

#### Example Use Cases

* **ERC-20 transfer**: Validate that the declared recipient matches the simulated execution.
* **Swap**: Detect mismatches between expected and actual tokens received.
* **Approval**: Detect infinite approvals or approvals to malicious addresses.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://txsentinel.gitbook.io/baibysitter/api/api-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.