Swap

Confirm swap execution with on-chain tx hash

After broadcasting the swap transaction, confirm it here with the tx hash. FarmDash verifies the transaction on-chain (10s timeout with LRU cache) and marks the fee event as settled. Idempotent — safe to retry.

post/agents/confirm

Request

  • Base URL: https://www.farmdash.one/api
  • URL: https://www.farmdash.one/api/agents/confirm
  • Auth: one of:
    • HTTP bearer
    • none

Headers

X-ClawHub-Skillstring
Example:farmdash-signal-architect

ClawHub skill attribution. An installed FarmDash skill sends its canonical skill slug (e.g. farmdash-signal-architect) on every FarmDash API request so anonymous Scout usage can be attributed to the skill that drove it. Optional and analytics-only: absence never blocks a request, and malformed values are ignored. This is a skill identity, never a wallet address, API key, or user ID.

Request body

sessionIdstring required

Owning FarmDash session id (the session that owns the fee event).

agentAddressstring required

Session owner / customer wallet address.

sessionTokenstring

Optional in this raw-HTTP schema: the session credential may be sent in the request body or via the X-FarmDash-Session-Token header. It authenticates the FarmDash session only; it is not wallet signing or transaction authority, and FarmDash never broadcasts the swap on the caller's behalf.

feeEventIdstring uuid required

FarmDash fee-event id associated with the prepared swap.

txHashstring required

On-chain transaction hash, which exists only after the customer-controlled wallet broadcast. A transaction hash alone is not confirmation: FarmDash verifies the canonical receipt/finality and the expected fee transfer before durable settlement is recorded.

Response

Confirmation result

okboolean
feeEventIdstring uuid
settlementStatus'confirmed' | 'pending' | 'expired'
idempotentboolean

True if this was a duplicate confirmation (safe to retry)

Changes

No recorded changes to this operation across all 1 revision of this API.