Merge branch 'main' into ms/adding-orca-dapp-docs

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/',
  },
  {

main/guides/orchestration/index.md

@@ -1,17 +1,26 @@
-# Orchestration Overview
+# What is Agoric Orchestration?
 
-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 capability allows developers to easily build cross-chain interactions into existing applications or to create novel cross-chain-focused products.
 
-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 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` 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 accounts on 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.
+
+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.
 
 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.
 

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: 📑