From 2e1bb61a0c9d68494d081268bb28a80a5494b88a Mon Sep 17 00:00:00 2001 From: 0xJ0 <4885245+Jovonni@users.noreply.github.com> Date: Mon, 7 Oct 2024 17:04:58 -0400 Subject: [PATCH 1/6] chore: orchestration landing page doc update for launch --- main/guides/orchestration/index.md | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/main/guides/orchestration/index.md b/main/guides/orchestration/index.md index b0a880472..ee76b7949 100644 --- a/main/guides/orchestration/index.md +++ b/main/guides/orchestration/index.md @@ -1,11 +1,20 @@ +# What is Agoric Orchestration + +Agoric’s Orchestration capability allows developers to easily build cross-chain capabilities into existing applications or to create novel cross-chain-focused products. + +The Agoric Orchestration API sits on top of Agoric’s novel VM that provides three key elements that make multichain applications possible: + +- **Remote account control and transfer**: Use the Orchestration APIs to easily create accounts on remote chains, transfer assets, and invoke contracts. Your Agoric contract orchestrates all behavior directly. +- **Multiblock execution with async & await**: Agoric applications communicate asynchronously and await responses which may come in the same block or many blocks (or weeks!) later. Contracts simply continue executing when the response arrives. +- **On-chain Timers**: Contracts can set timers for regular execution which makes executing common activities like subscriptions easy. + +Agoric’s Orchestration APIs simplify controlling remote chains, moving assets, and using capabilities on any chain the API reaches. + # Orchestration Overview -Agoric's Orchestration API is a tool to help developers build seamless applications out of disparate interoperable chains and services. -This composability allows for the development of user-centric applications that leverage the unique strengths of different blockchain ecosystems. +Agoric's Orchestration API is a tool to help developers build seamless applications out of disparate interoperable chains and services. This composability allows for the development of user-centric applications that leverage the unique strengths of different blockchain ecosystems. -The Agoric Orchestration API simplifies interactions between multiple networks, particularly those -using the [Inter-Blockchain Communication (IBC)](/glossary/#ibc) protocol within Cosmos. The API acts as an -abstraction layer, streamlining multi-step processes. +The Agoric Orchestration API simplifies interactions between multiple networks, particularly those using the [Inter-Blockchain Communication (IBC)](/glossary/#ibc) protocol within Cosmos. The API acts as an abstraction layer, streamlining multi-step processes. Orchestration integrates with existing Agoric components ([SwingSet](/guides/platform/#swingset), Cosmos modules) and introduces vat-orchestration. This [vat](/glossary/#vat) manages Inter-Chain Account (ICA) identities and connections to host chains, ensuring proper transaction authorization. From b2b7dd9db32367eebfc8ec0180712abfcc19e3f8 Mon Sep 17 00:00:00 2001 From: jovonni Date: Mon, 7 Oct 2024 17:23:33 -0400 Subject: [PATCH 2/6] chore: question mark typo fix --- main/guides/orchestration/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/main/guides/orchestration/index.md b/main/guides/orchestration/index.md index ee76b7949..1d76aa110 100644 --- a/main/guides/orchestration/index.md +++ b/main/guides/orchestration/index.md @@ -1,4 +1,4 @@ -# What is Agoric Orchestration +# What is Agoric Orchestration? Agoric’s Orchestration capability allows developers to easily build cross-chain capabilities into existing applications or to create novel cross-chain-focused products. From c4bdf89767389de6ee20f9f817127f40359840c9 Mon Sep 17 00:00:00 2001 From: 0xJ0 <4885245+Jovonni@users.noreply.github.com> Date: Tue, 8 Oct 2024 10:34:08 -0400 Subject: [PATCH 3/6] Update main/guides/orchestration/index.md Co-authored-by: Mujahid Khan <106528609+mujahidkay@users.noreply.github.com> --- main/guides/orchestration/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/main/guides/orchestration/index.md b/main/guides/orchestration/index.md index 1d76aa110..76b57b431 100644 --- a/main/guides/orchestration/index.md +++ b/main/guides/orchestration/index.md @@ -8,7 +8,7 @@ The Agoric Orchestration API sits on top of Agoric’s novel VM that provides th - **Multiblock execution with async & await**: Agoric applications communicate asynchronously and await responses which may come in the same block or many blocks (or weeks!) later. Contracts simply continue executing when the response arrives. - **On-chain Timers**: Contracts can set timers for regular execution which makes executing common activities like subscriptions easy. -Agoric’s Orchestration APIs simplify controlling remote chains, moving assets, and using capabilities on any chain the API reaches. +Agoric’s Orchestration API simplifies controlling remote chains, moving assets, and using capabilities on any chain the API reaches. # Orchestration Overview From b9727957b496f17e5c030c40dab47f53108247b1 Mon Sep 17 00:00:00 2001 From: jovonni Date: Tue, 8 Oct 2024 11:28:45 -0400 Subject: [PATCH 4/6] chore: updated orch nav menu --- main/.vitepress/themeConfig/nav.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/main/.vitepress/themeConfig/nav.js b/main/.vitepress/themeConfig/nav.js index ebabdd189..0f4cdf67f 100644 --- a/main/.vitepress/themeConfig/nav.js +++ b/main/.vitepress/themeConfig/nav.js @@ -10,7 +10,7 @@ export const nav = [ collapsed: true, items: [ { - text: 'What is Orchestration?', + text: 'What is Agoric Orchestration?', link: '/guides/orchestration/', }, { From 93bec15f2f2d123f8943b671ef2ac56dacf6a775 Mon Sep 17 00:00:00 2001 From: jovonni Date: Tue, 8 Oct 2024 11:29:56 -0400 Subject: [PATCH 5/6] chore: fix typos, update verbiage, and formatting --- main/guides/orchestration/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/main/guides/orchestration/index.md b/main/guides/orchestration/index.md index 76b57b431..9e2929a10 100644 --- a/main/guides/orchestration/index.md +++ b/main/guides/orchestration/index.md @@ -1,16 +1,16 @@ # What is Agoric Orchestration? -Agoric’s Orchestration capability allows developers to easily build cross-chain capabilities into existing applications or to create novel cross-chain-focused products. +Agoric’s Orchestration capability allows developers to easily build cross-chain interactions into existing applications or to create novel cross-chain-focused products. The Agoric Orchestration API sits on top of Agoric’s novel VM that provides three key elements that make multichain applications possible: - **Remote account control and transfer**: Use the Orchestration APIs to easily create accounts on remote chains, transfer assets, and invoke contracts. Your Agoric contract orchestrates all behavior directly. -- **Multiblock execution with async & await**: Agoric applications communicate asynchronously and await responses which may come in the same block or many blocks (or weeks!) later. Contracts simply continue executing when the response arrives. +- **Multiblock execution with `async` and `await`**: Agoric applications communicate asynchronously and await responses which may come in the same block or many blocks (or weeks!) later. Contracts simply continue executing when the response arrives. - **On-chain Timers**: Contracts can set timers for regular execution which makes executing common activities like subscriptions easy. -Agoric’s Orchestration API simplifies controlling remote chains, moving assets, and using capabilities on any chain the API reaches. +Agoric’s Orchestration APIs simplify controlling remote chains, moving assets, and using capabilities on any chain the API reaches. -# Orchestration Overview +## Orchestration Overview Agoric's Orchestration API is a tool to help developers build seamless applications out of disparate interoperable chains and services. This composability allows for the development of user-centric applications that leverage the unique strengths of different blockchain ecosystems. @@ -20,7 +20,7 @@ Orchestration integrates with existing Agoric components ([SwingSet](/guides/pla The Orchestration API handles asynchronous tasks and complex workflows, including those spanning multiple chains. This empowers smart contracts for actions like inter-chain staking and multi-hop transfers, facilitated by notifications from the transfer vat and IBC middleware updates. Orchestration simplifies complex cross-chain interactions within a secure and user-controlled environment on the Agoric platform. -# Introduction to Orchestration API Flow +## Introduction to Orchestration API Flow The following sequence diagram provides a comprehensive overview of the orchestration process within the Agoric platform. This example illustrates the interaction between various components, highlighting how the orchestration library (`OrchLib`) facilitates cross-chain operations. This is a good first example to understand the flow of the Orchestration API, showing the steps involved in creating and managing cross-chain transactions. From ed440676b546af3b15e6d9392ba97cf8d4d91015 Mon Sep 17 00:00:00 2001 From: jovonni Date: Tue, 8 Oct 2024 13:30:09 -0400 Subject: [PATCH 6/6] chore: clarifying accounts on remote chains --- main/guides/orchestration/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/main/guides/orchestration/index.md b/main/guides/orchestration/index.md index 9e2929a10..34083a2be 100644 --- a/main/guides/orchestration/index.md +++ b/main/guides/orchestration/index.md @@ -8,7 +8,7 @@ The Agoric Orchestration API sits on top of Agoric’s novel VM that provides th - **Multiblock execution with `async` and `await`**: Agoric applications communicate asynchronously and await responses which may come in the same block or many blocks (or weeks!) later. Contracts simply continue executing when the response arrives. - **On-chain Timers**: Contracts can set timers for regular execution which makes executing common activities like subscriptions easy. -Agoric’s Orchestration APIs simplify controlling remote chains, moving assets, and using capabilities on any chain the API reaches. +Agoric’s Orchestration APIs simplify controlling accounts on remote chains, moving assets, and using capabilities on any chain the API reaches. ## Orchestration Overview