Skip to main content

Unlock Attestations

As detailed in Pool Unlock, Angstrom pools begin each block locked to protect auction settlement. When no batch trade runs, the lock persists unless a transaction carries valid unlock data, so routers and solvers rely on unlock attestations to safely access liquidity.

note

If you submit a transaction to integrated block builders like Titan or BTCS without including an unlock attestation, they will automatically unlock the pool for you.

Obtaining Unlock Attestations​

You can receive unlock attestations 3 different ways:

  1. Streaming them directly from Angstrom nodes with the subscribeEmptyBlockAttestations WS endpoint.
    • These attestations are only valid for the next block.
  2. Using our Attestations API to generate valid block attestations for future blocks.
    • multi-block guarantee
    • requires an API key, reach out to our team to obtain one
  3. Fetching a quote from our RFQ API.
    • These attestations are bundled into your swap executable

Using Unlock Attestations​

Single-block attestations streamed from subscribeEmptyBlockAttestations are only valid for the next block. Pass the attestation signature in hookData when invoking the Uni V4 swap.

For multi-block attestations returned by the Attestations API, either use the Angstrom Adapter so it selects the signature for the target block, or manage the set yourself and supply the matching attestation in hookData for the block you intend to unlock.

  • Note: Unlock attestations are ignored if the pool is already unlocked from an executed bundle.