putty
API ReferenceTools

Report a signed transaction hash

Records the hash of a transaction the **caller** signed, and moves the request to `submitted`. This is how an external agent that signed with its own wallet keeps launch status and the Onchain page accurate; the dashboard's sign-request modal posts here after the user's Privy wallet returns a hash. The worker then confirms the receipt onchain and moves the request to `confirmed` or `failed`. Reporting a hash twice is accepted and keeps the first one — a client that retried after a timeout must not rewrite the row. A request owned by another user answers with the same 404 as one that does not exist.

POST
/tx/{id}/submitted

Records the hash of a transaction the caller signed, and moves the request to submitted. This is how an external agent that signed with its own wallet keeps launch status and the Onchain page accurate; the dashboard's sign-request modal posts here after the user's Privy wallet returns a hash. The worker then confirms the receipt onchain and moves the request to confirmed or failed. Reporting a hash twice is accepted and keeps the first one — a client that retried after a timeout must not rewrite the row. A request owned by another user answers with the same 404 as one that does not exist.

Path Parameters

id*string

The request id the hash belongs to.

Request Body

application/json

The hash the caller signed with.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/tx/string/submitted" \  -H "Content-Type: application/json" \  -d '{    "txHash": "string"  }'
{  "id": "string",  "ownerId": "string",  "chainSlug": "ethereum",  "unsignedTx": {    "chainId": 0,    "to": "string",    "data": "string",    "value": "string"  },  "summary": [    "string"  ],  "simulation": {    "ok": true,    "balanceChanges": [      {        "token": "string",        "symbol": "string",        "delta": "string"      }    ],    "events": [      "string"    ]  },  "fees": [    {      "label": "string",      "bps": 0    }  ],  "delivery": "dashboard",  "status": "pending",  "txHash": "string",  "dependsOn": "string",  "createdAt": "string",  "expiresAt": "string"}