From 811e2470e7de3207dfcdeaab99766170655557cf 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/7] 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 1d378b23ee9b47409804a18d69a736ec649cb679 Mon Sep 17 00:00:00 2001 From: jovonni Date: Mon, 7 Oct 2024 17:23:33 -0400 Subject: [PATCH 2/7] 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 32957b9e7312ab656f95b7af5004d2a9696add47 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/7] 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 9cd6a5d4dcbfbb7612ae7a2eb3d3f3f7dbe3929f Mon Sep 17 00:00:00 2001 From: jovonni Date: Tue, 8 Oct 2024 11:28:45 -0400 Subject: [PATCH 4/7] 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 8cc91497dcba6a406edb1820ab0e2a6430330835 Mon Sep 17 00:00:00 2001 From: jovonni Date: Tue, 8 Oct 2024 11:29:56 -0400 Subject: [PATCH 5/7] 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 cebe1ff96df659098ca24f0cc0820975523ae672 Mon Sep 17 00:00:00 2001 From: jovonni Date: Tue, 8 Oct 2024 13:30:09 -0400 Subject: [PATCH 6/7] 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 From 5ddec88933c06fc9ea6028dd272eb9962d2a38d3 Mon Sep 17 00:00:00 2001 From: Mujahid Khan <106528609+mujahidkay@users.noreply.github.com> Date: Mon, 7 Oct 2024 19:01:53 +0500 Subject: [PATCH 7/7] chore: update Build card on main page --- main/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/main/index.md b/main/index.md index b71be4ab0..255e712dc 100644 --- a/main/index.md +++ b/main/index.md @@ -44,7 +44,7 @@ features: - icon: 🛠️ title: Build - details: Build Cross Chain Smart Contracts using Agoric Orchestration APIs + details: Deploy your first Agoric dapp link: /guides/getting-started/ - icon: 📑