> For the complete documentation index, see [llms.txt](https://docs.blockz.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockz.fi/integration/user-flow.md).

# User Flow

The Blockz execution flow involves three primary actors:

* **Partner** – the integrating platform (wallet, app, exchange, or service) interacting with the Blockz API
* **User** – the asset owner initiating the swap
* **Resolver** – the liquidity provider fulfilling the intent

Resolvers provide liquidity and perform the on-chain execution required to fulfill swap intents.

Blockz coordinates communication, validation, and cross-chain settlement without taking custody of funds.

{% stepper %}
{% step %}

#### Quote Request

The user defines the asset pair and amount to be exchanged.

The partner submits these parameters to the [Blockz Quote API](/api/get-quote.md). Blockz returns an RFQ-based quote representing a time-bound execution offer sourced from competing resolvers. The quote includes pricing, fees, and execution constraints.
{% endstep %}

{% step %}

#### Intent Creation

If the user accepts the quote, it [creates an intent](/api/submit-intent.md) referencing:

* The selected quote identifier
* The user’s source and destination addresses
* The agreed swap parameters

The intent is a structured, machine-verifiable representation of the user’s desired outcome.
{% endstep %}

{% step %}

#### Intent Signing

After intent creation, Blockz returns the chain-specific data that must be signed by the user.

The signed intent includes the selected quote identifier, source and destination assets, amount, participating networks, and the user’s source and destination addresses.

The user signs the intent off-chain, cryptographically approving the swap parameters and authorizing execution according to the quoted conditions.

Depending on the network, the user may also provide authorization for the resolver or settlement mechanism to transfer the required assets during execution.
{% endstep %}

{% step %}

#### Execution

Once the signed intent is submitted:

* Blockz notifies the resolver that won the quote to begin execution
* The resolver initiates settlement according to the intent conditions
* Depending on the network, the resolver may transfer the user's approved assets into an escrow or equivalent settlement mechanism on the source chain
* The resolver delivers the corresponding assets to the user on the destination chain

Settlement logic ensures deterministic completion or reversion, preventing partial execution.

The partner can monitor execution status through the Blockz Intent API.
{% endstep %}
{% endstepper %}