Skip to content

Commit

Permalink
GITBOOK-353: change request with no subject merged in GitBook
Browse files Browse the repository at this point in the history
  • Loading branch information
Alex Smirnov authored and gitbook-bot committed Oct 8, 2024
1 parent 495a877 commit 003de41
Show file tree
Hide file tree
Showing 3 changed files with 5 additions and 5 deletions.
2 changes: 1 addition & 1 deletion docs/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@

* [Introduction](dln-the-debridge-liquidity-network-protocol/introduction.md)
* [Protocol Overview](dln-the-debridge-liquidity-network-protocol/protocol-overview.md)
* [DLN Hooks](dln-the-debridge-liquidity-network-protocol/dln-hooks.md)
* [deBridge Hooks](dln-the-debridge-liquidity-network-protocol/debridge-hooks.md)
* [Fees and Supported Chains](dln-the-debridge-liquidity-network-protocol/fees-and-supported-chains.md)
* [🟢 Deployed Contracts](dln-the-debridge-liquidity-network-protocol/deployed-contracts.md)
* [Market and Limit Orders](dln-the-debridge-liquidity-network-protocol/market-and-limit-orders.md)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
description: >-
DLN Hooks is a core feature of the DLN protocol that allows users, protocols
DLN Hooks is a core feature of the DLN protocol that allows users, protocols,
and market makers to attach arbitrary on-chain actions to the orders that
would get executed upon their fulfillment.
---

# DLN Hooks
# deBridge Hooks

The DLN protocol allows users to place cross-chain orders with an arbitrary on-chain action attached as an inseparable part of it, enabling cryptographically signed operations to be performed on the destination chain upon order fulfillment.

Expand Down Expand Up @@ -69,7 +69,7 @@ The DLN API simplifies a hook's cost estimation by automatically simulating tran

A common source of frustration is a blockchain where a hook is expected to run: hooks are built for destination chains. For example, an order that sells SOL on Solana and buys ETH on Ethereum would get placed on Solana with the hook data encoded specifically for EVM, and vice versa.

Atomic **success-required hooks** that get reverted would prevent their orders from getting fulfilled, causing users' funds to stuck, which would require users to initiate [a cancellation procedure](interacting-with-the-api/cancelling-the-order.md). This increases friction and worsens overall user experience, so it is advised to carefully test hooks and estimate potential fulfillments prior placing orders with such hooks. The API [takes the burden](interacting-with-the-api/integrating-dln-hooks/) of proper hook data validation, encoding, and hook simulation, ensuring that an order could get filled on the destination chain. 
Atomic **success-required hooks** that get reverted would prevent their orders from getting fulfilled, causing users' funds to stuck, which would require users to initiate [a cancellation procedure](interacting-with-the-api/cancelling-the-order.md). This increases friction and worsens the overall user experience, so it is advised to carefully test hooks and estimate potential fulfillments prior placing orders with such hooks. The API [takes the burden](interacting-with-the-api/integrating-dln-hooks/) of proper hook data validation, encoding, and hook simulation, ensuring that an order could get filled on the destination chain. 

### Examples

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ DLN Source
| ------------------------ | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DlnSource` | `0xeF4fB24aD0916217251F553c0596F8Edc630EB66` | Used to place orders on DLN |
| `DlnDestination` | `0xe7351fd770a37282b91d153ee690b63579d6dd7f` | Used to fulfill and cancel orders placed on DLN |
| `DlnExternalCallAdapter` | `0x61eF2e01E603aEB5Cd96F9eC9AE76cc6A68f6cF9` | Intermediary store and the engine for [DLN Hooks](dln-hooks.md) that implement `IExternalCallExecutor` (see below) |
| `DlnExternalCallAdapter` | `0x61eF2e01E603aEB5Cd96F9eC9AE76cc6A68f6cF9` | Intermediary store and the engine for [DLN Hooks](debridge-hooks.md) that implement `IExternalCallExecutor` (see below) |
| `ExternalCallExecutor` | `0xFC2CA4022d26AD4dCb3866ae30669669F6A28f19` | [Universal DLN Hook](protocol-specs/hook-data/anatomy-of-a-hook-for-the-evm-based-chains.md) (implementing `IExternalCallExecutor`) that executes arbitrary transaction calls bypassed via a payload |
| `CrosschainForwarder` | `0x663dc15d3c1ac63ff12e45ab68fea3f0a883c251` | Intermediary smart contract used exclusively by the DLN API to sell input assets for trusted liquid assets prior order created, if necessary. |

Expand Down

0 comments on commit 003de41

Please sign in to comment.