Skip to content

Add comprehensive multichain testing documentation #1279

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Jul 18, 2025

This PR adds comprehensive documentation for Agoric's multichain testing framework, addressing the need for developers to understand how to test cross-chain applications.

What's Added

📖 New Documentation Page: /multichain-testing

  • What is multichain testing - Comprehensive explanation of testing cross-chain applications
  • Architecture overview - Details about the Starship-powered testing framework
  • Prerequisites - System requirements, software dependencies, and knowledge requirements
  • Resource requirements - Detailed table showing CPU/memory needs for different chains
  • Setup instructions - Step-by-step guide with commands and verification steps
  • Configuration options - Multiple config files for different testing scenarios
  • Test suites - Organized test categories (main, Fast USDC, queries, staking)
  • Example test scenarios - Real TypeScript code examples for common patterns
  • Testing patterns - Asynchronous operations, error handling, state verification
  • Best practices - Test organization, resource management, debugging, performance
  • Troubleshooting - Common issues, debugging tools, and solutions
  • Advanced topics - Custom configurations, relayer options, CI/CD integration

🔧 Navigation Updates

  • Added "Multichain Testing" link in the Build section of the VitePress navigation
  • Positioned after "End-to-End Testing" for logical flow

Key Features

The documentation covers:

  • Multiple blockchain networks (Agoric, Osmosis, Cosmos Hub, Noble)
  • IBC relayer testing (both Hermes and Go relayers)
  • Real test examples with TypeScript code
  • Resource planning with specific CPU/memory requirements
  • Comprehensive troubleshooting guide
  • Integration patterns for CI/CD pipelines

Visual Preview

Multichain Testing Documentation

The documentation provides developers with essential guidance for testing orchestration-based smart contracts that interact with multiple blockchain networks, making it easier to build reliable cross-chain applications on Agoric.

Fixes #1273.


💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Copy link

cloudflare-workers-and-pages bot commented Jul 18, 2025

Deploying documentation with  Cloudflare Pages  Cloudflare Pages

Latest commit: ef251a0
Status: ✅  Deploy successful!
Preview URL: https://ff21557a.documentation-7tp.pages.dev
Branch Preview URL: https://copilot-fix-1273.documentation-7tp.pages.dev

View logs

@Copilot Copilot AI changed the title [WIP] Multichain-testing is missing from Docs Add comprehensive multichain testing documentation Jul 18, 2025
@Copilot Copilot AI requested a review from toliaqat July 18, 2025 05:59
Copilot finished work on behalf of toliaqat July 18, 2025 05:59
@toliaqat toliaqat requested a review from amessbee July 18, 2025 06:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Multichain-testing is missing from Docs
3 participants