[STELLAR] Add Stellar Testnet configuration helper and client utilities

[Obiajulu-gif]

Overview

Create a reusable Stellar configuration layer for ChainMove so future Stellar features can use one safe, typed source of truth.

Problem

ChainMove is moving toward Stellar, but the project needs a clean configuration helper before adding account linking, asset issuance, Horizon reads, Stellar RPC calls, or Soroban contract interactions.

Expected solution

Create a Stellar config module, for example:

lib/stellar/config.ts
lib/stellar/client.ts

The module should read and validate:

STELLAR_NETWORK=testnet
STELLAR_HORIZON_URL=https://horizon-testnet.stellar.org
STELLAR_RPC_URL=https://soroban-testnet.stellar.org
STELLAR_ASSET_CODE=CMOVE
STELLAR_ISSUER_PUBLIC_KEY=replace_with_public_key
STELLAR_DISTRIBUTION_PUBLIC_KEY=replace_with_public_key
STELLAR_CONTRACT_ID=replace_after_deployment
ENABLE_MOCK_STELLAR=true

Requirements

• Support testnet and future mainnet values.
• Avoid exposing server-only values to the frontend.
• Do not store or require Stellar private keys.
• Export safe helpers for Horizon and Stellar RPC URLs.
• Add clear errors for missing required values when mock mode is disabled.

Files likely involved

• lib/stellar/config.ts
• lib/stellar/client.ts
• .env.example
• README or Stellar docs

Acceptance criteria

• Stellar config helper exists and is typed.
• Missing config is handled clearly.
• Mock mode can bypass required Stellar network config for local development.
• No Stellar secret key is introduced.
• Lint and build pass.

Suggested labels

stellar, backend, configuration, developer-experience

Difficulty

Beginner / Intermediate

[Dataguru-tech]

Hi maintainer, I would like to work on this issue. I have hands-on experience with Stellar ecosystem tooling, including Horizon and Soroban RPC integrations, and I understand the importance of getting a clean, typed configuration layer in place before layering on account linking, asset issuance, and contract interactions.

[Arome8240]

Hello, I'm a smart contract and full stack developer, open for contributions. contributed to over 20 project on OnlyDust and Drips , with expertise in Solidity, Cairo, JavaScript, TypeScript, and RUST. I am passionate about building secure and scalable blockchain solutions, and I would love the opportunity to contribute my skills toward solving this issue.

[Menjay7]

Hi! I came across this issue and would love to work on it. I have experience with similar tasks and I'm confident I can investigate, implement a clean solution, and thoroughly test it before submitting a PR. If the issue is still open, I would appreciate it if you could assign it to me. Thank you!

[Marvy247]

I've reviewed the issue description, and I'm confident I can implement all the requested details smoothly.​ Please assign this issue to me! I can have a PR ready for review in a few hours.
Thank You.

[Adamsonoladipupo]

CAN I WORK ON THIS PLEASE?

[jaynomyaro]

Hi! I’m a full-stack developer with a strong blockchain background. I’d love to handle this issue and can deliver a clean, reliable solution. Kindly assign it to me.

[Ekenesamuel8]

hello maintainer, i can handle this issue. Please assign it to me

[grantfox-oss]

🦊 GrantFox — @Ekenesamuel8 has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #26)
2. Your PR will be reviewed by the Chainmove maintainers

Good luck! Track your progress on GrantFox.