diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 556a8c52..fa6a7175 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -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) diff --git a/docs/dln-the-debridge-liquidity-network-protocol/dln-hooks.md b/docs/dln-the-debridge-liquidity-network-protocol/debridge-hooks.md similarity index 95% rename from docs/dln-the-debridge-liquidity-network-protocol/dln-hooks.md rename to docs/dln-the-debridge-liquidity-network-protocol/debridge-hooks.md index 1433fe4d..e3d0c94e 100644 --- a/docs/dln-the-debridge-liquidity-network-protocol/dln-hooks.md +++ b/docs/dln-the-debridge-liquidity-network-protocol/debridge-hooks.md @@ -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. @@ -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 diff --git a/docs/dln-the-debridge-liquidity-network-protocol/deployed-contracts.md b/docs/dln-the-debridge-liquidity-network-protocol/deployed-contracts.md index 279d23a1..b9e14928 100644 --- a/docs/dln-the-debridge-liquidity-network-protocol/deployed-contracts.md +++ b/docs/dln-the-debridge-liquidity-network-protocol/deployed-contracts.md @@ -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. |