diff --git a/docs/build/isc/v1.0.0-rc.6/docs/_partials/_on_off_ledger_request.md b/docs/build/isc/v1.0.0-rc.6/docs/_partials/_on_off_ledger_request.md new file mode 100644 index 00000000000..5cc4da7bb54 --- /dev/null +++ b/docs/build/isc/v1.0.0-rc.6/docs/_partials/_on_off_ledger_request.md @@ -0,0 +1,14 @@ +### On-Ledger Requests + +An on-ledger request is a Layer 1 transaction that validator nodes retrieve from the Tangle. The Tangle acts as an +arbiter between users and chains and guarantees that the transaction is valid, making it the only way to transfer assets +to a chain or between chains. However, it is the slowest way to invoke a smart contract. + +### Off-Ledger Requests + +If all necessary assets are in the chain already, it is possible to send a request directly to that chain's validator +nodes. +This way, you don’t have to wait for the Tangle to process the message, significantly reducing the overall confirmation +time. +Due to the shorter delay, off-ledger requests are preferred over on-ledger requests unless you need to move assets +between chains or Layer 1 accounts. \ No newline at end of file diff --git a/docs/build/isc/v1.0.0-rc.6/docs/explanations/invocation.md b/docs/build/isc/v1.0.0-rc.6/docs/explanations/invocation.md index 2eed8ebd08e..8a27d8e0c3e 100644 --- a/docs/build/isc/v1.0.0-rc.6/docs/explanations/invocation.md +++ b/docs/build/isc/v1.0.0-rc.6/docs/explanations/invocation.md @@ -14,6 +14,8 @@ tags: --- +import OnOffLedgerRequest from '../_partials/_on_off_ledger_request.md'; + # Calling a Smart Contract ## Entry Points @@ -63,20 +65,7 @@ exchange which would will the user's funds from one currency to another and send This is called _asynchronous composability_. -### On-Ledger Requests - -An on-ledger request is a Layer 1 transaction that validator nodes retrieve from the Tangle. The Tangle acts as an -arbiter between users and chains and guarantees that the transaction is valid, making it the only way to transfer assets -to a chain or between chains. However, it is the slowest way to invoke a smart contract. - -### Off-Ledger Requests - -If all necessary assets are in the chain already, it is possible to send a request directly to that chain's validator -nodes. -This way, you don’t have to wait for the Tangle to process the message, significantly reducing the overall confirmation -time. -Due to the shorter delay, off-ledger requests are preferred over on-ledger requests unless you need to move assets -between chains or Layer 1 accounts. + --- diff --git a/docs/build/isc/v1.0.0-rc.6/docs/introduction.md b/docs/build/isc/v1.0.0-rc.6/docs/introduction.md index 550ef4aaa94..4fb90e4d59a 100644 --- a/docs/build/isc/v1.0.0-rc.6/docs/introduction.md +++ b/docs/build/isc/v1.0.0-rc.6/docs/introduction.md @@ -12,6 +12,7 @@ tags: --- import NetworkWarning from './_admonitions/_network_warning.md' +import OnOffLedgerRequest from './_partials/_on_off_ledger_request.md'; # Introduction @@ -72,8 +73,4 @@ may involve delays. Running a request consumes 'gas', that is the cost of executing an on-chain request. You can specify a `GasBudget` for each request, with costs charged to your on-chain account. -## On-Ledger vs Off-Ledger Requests - -Requests can be [on-ledger](explanations/invocation.md#on-ledger-requests), that is, processed through -the Tangle, or [off-ledger](explanations/invocation.md#off-ledger-requests), directly sent to validators for faster -processing. +