Skip to content

Conversation

@faisal-chainlink
Copy link
Contributor

@faisal-chainlink faisal-chainlink commented Feb 2, 2026

Adds the Stellar family component using their recommended quickstart image. The image includes all the necessary services required for testing. The PR also adds a very basic test to check that services can be spun up and are healthy.


Below is a summarization created by an LLM (gpt-4-0125-preview). Be mindful of hallucinations and verify accuracy.

Why

The changes introduce support for Stellar blockchain, expanding the framework's capability to interact with a broader range of blockchain technologies. This includes the ability to run Stellar nodes for development and testing purposes, interact with the Stellar network, and perform operations like funding accounts through the Friendbot service.

What

  • framework/components/blockchain/blockchain.go
    • Added TypeStellar constant to represent Stellar blockchain nodes.
    • Included FamilyStellar in blockchain node families to categorize Stellar under a specific family.
    • Updated Input struct to support Stellar by adding it to the list of valid types and updating comments to reflect this addition.
    • Updated Output struct to include Stellar in the list of valid types and blockchain families, ensuring outputs can correctly represent Stellar networks.
    • Added case for TypeStellar in NewWithContext function to handle Stellar blockchain initialization.
    • Included TypeStellar case in TypeToFamily function, mapping Stellar type to its family.
  • framework/components/blockchain/stellar.go (New File)
    • Implemented Stellar blockchain support, including default image and ports for running a Stellar node using Docker.
    • Provided functionality to initialize a Stellar node, configure it for local development, and ensure it's ready for interaction.
    • Added utility functions to check the health of the Stellar RPC endpoint and to wait for it to become ready.
  • framework/examples/myproject/smoke_stellar.toml (New File)
    • Created a new TOML configuration example for setting up and running a Stellar blockchain node.
  • framework/examples/myproject/smoke_stellar_test.go (New File)
    • Added a new test file to demonstrate how to interact with a Stellar node, verify its health, and perform a basic operation like funding an account using Friendbot.

These changes broaden the framework's blockchain support to include Stellar, facilitating development and testing activities on the Stellar network within the same framework used for other blockchain technologies.

@faisal-chainlink faisal-chainlink requested a review from a team as a code owner February 2, 2026 19:00
Copilot AI review requested due to automatic review settings February 2, 2026 19:00
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds support for the Stellar blockchain family to the testing framework using the official stellar/quickstart Docker image. The implementation includes a basic smoke test to verify that Stellar services can be properly initialized and are healthy.

Changes:

  • Added Stellar blockchain type and family constants to the framework
  • Implemented Stellar-specific container setup with RPC endpoint configuration
  • Created a smoke test that verifies RPC health, network info, and Friendbot account funding functionality

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
framework/components/blockchain/stellar.go Implements Stellar blockchain component with container setup, RPC health checks, and network configuration
framework/components/blockchain/blockchain.go Registers Stellar as a supported blockchain type and family in the framework
framework/examples/myproject/smoke_stellar_test.go Provides smoke tests for Stellar RPC health, network info retrieval, and Friendbot account funding
framework/examples/myproject/smoke_stellar.toml Contains Stellar blockchain configuration for the smoke test

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions
Copy link

github-actions bot commented Feb 2, 2026

👋 faisal-chainlink, thanks for creating this pull request!

To help reviewers, please consider creating future PRs as drafts first. This allows you to self-review and make any final changes before notifying the team.

Once you're ready, you can mark it as "Ready for review" to request feedback. Thanks!

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.

1 participant