soroswap / soroswap/docs

Aggregator docs say Phoenix and Aqua are on Testnet or coming soon; mainnet adapters are configured and unpaused

Open Beginner friendly
#47 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
MDX
Stars
2
Forks
6
PR merge metrics
No merged PRs in 30d

Description

[!NOTE]
Automated notice: Stellar Raven filed this issue from its automated evaluation pipeline. The issue includes evidence and a public source record. Please verify the live surface before you act.

Finding

Two published Soroswap docs pages give a stale status for aggregator liquidity sources.
concepts/aggregator.mdx labels Phoenix Protocol AMM and Aqua AMM as "(currently on Testnet)".
aggregator/supported-amms.mdx labels Aquarius AMM "(Coming Soon)".
The mainnet aggregator already has registered, unpaused Phoenix and Aqua adapters.

Evidence

Both pages describe the aggregator's current sources. concepts/aggregator.mdx:10 refers to AMMs
"currently deployed on the Soroban-Stellar Mainnet". The aggregator index card describes
supported-amms as "Which protocols the aggregator currently routes through."

public/mainnet.contracts.json in soroswap/aggregator names aggregator
CAYP3UWLJM7ZPTUKL6R6BFGTRWLZ46LRKOXTERI2K6BIJAWGYY62TXTO. The on-chain WASM hash matches that record.
A read-only simulateTransaction of get_adapters() returns:

protocol_id Protocol (models.rs) router paused
0 Soroswap CAG5LRYQ5JVEUI5TEID72EYOVX44TTUJT5BQR2J6J77FH65PCCFAJDDH false
1 Phoenix CCLZRD4E72T7JCZCN3P7KNPYNXFYKQCL64ECLX7WP5GNVYPYJGU2IO2G false
2 Aqua CBQDHNBFBZYE4MKPWBSJOPIYLW4SFSXAXUTSXJN76GNKYVYPCKWC6QUK false

Reproduce with @stellar/stellar-sdk 17.1.0. The transaction is unsigned and not submitted:

import { Account, Contract, Keypair, Networks, TransactionBuilder, BASE_FEE, rpc, scValToNative } from "@stellar/stellar-sdk";
const server = new rpc.Server("https://mainnet.sorobanrpc.com");
const tx = new TransactionBuilder(new Account(Keypair.random().publicKey(), "0"), { fee: BASE_FEE, networkPassphrase: Networks.PUBLIC })
  .addOperation(new Contract("CAYP3UWLJM7ZPTUKL6R6BFGTRWLZ46LRKOXTERI2K6BIJAWGYY62TXTO").call("get_adapters"))
  .setTimeout(30).build();
const sim = await server.simulateTransaction(tx);
console.log(scValToNative(sim.result.retval));

This check shows configuration and pause state only. It does not show a successful swap.

Additional recorded evidence:

  • Docs source: soroswap/docs main 1d7a3c8a85616918415056ad2a0f6d2177fc1948 (2026-09-06). concepts/aggregator.mdx:13-14 marks Phoenix Protocol AMM and Aqua AMM as (currently on Testnet). aggregator/supported-amms.mdx:12 marks Aquarius AMM (Coming Soon); its frontmatter description says Aquarius is coming soon. Both files were last changed in 0da69fc2 (2026-09-01).
  • Scope: concepts/aggregator.mdx:10 describes AMMs currently deployed on the Soroban-Stellar Mainnet that the aggregator currently uses. The aggregator/index.mdx card says supported-amms lists the protocols the aggregator currently routes through. Both pages are in docs.json navigation. On 2026-09-17, both pages returned HTTP 200 and rendered the stale labels.
  • Adjacent docs: api/index.mdx:19 already names Soroswap, Phoenix, Aqua and SDEX for API quotes and routes. That page describes the API, which also covers SDEX.
  • Deployment record: soroswap/aggregator public/mainnet.contracts.json, last changed in 82c15fd2 (Deploy Aggregator with Aqua, 2025-06-16), lists aggregator CAYP3UWLJM7ZPTUKL6R6BFGTRWLZ46LRKOXTERI2K6BIJAWGYY62TXTO with WASM hash 5e0bff5a29e2473b5289fe96aeb59b48ac335e5e87c46632b53be1f662447d2c. The on-chain instance has the same hash. contracts/aggregator/src/models.rs maps Soroswap=0, Phoenix=1, Aqua=2, Comet=3 at both 82c15fd2 and main 84de10e0.
  • 2026-09-17T01:30Z read-only simulateTransaction of get_adapters on that aggregator, unsigned and never submitted, through https://mainnet.sorobanrpc.com and https://rpc.lightsail.network at ledger 64464571: protocol_id 0, 1, and 2 are configured with paused false. Routers: Soroswap CAG5LRYQ5JVEUI5TEID72EYOVX44TTUJT5BQR2J6J77FH65PCCFAJDDH, Phoenix CCLZRD4E72T7JCZCN3P7KNPYNXFYKQCL64ECLX7WP5GNVYPYJGU2IO2G, Aqua CBQDHNBFBZYE4MKPWBSJOPIYLW4SFSXAXUTSXJN76GNKYVYPCKWC6QUK. All three router contract instances exist on mainnet.
  • An independent coordinator reproduction through both RPC providers at ledger 64464708 returned the same three unpaused adapters.
  • No swap was simulated or submitted. This evidence shows adapter configuration and pause state, not swap success or liquidity.
  • Dedupe 2026-09-17: no soroswap/docs or soroswap/aggregator issue or PR covers Phoenix, Aqua, testnet status, or supported AMMs. Open soroswap/docs #39 (generic upgrade checklist) and #42 (deployed contracts, empty body) do not cover adapter status.

Recommendation

Update concepts/aggregator.mdx and aggregator/supported-amms.mdx to list Soroswap, Phoenix, and
Aqua/Aquarius as current mainnet aggregator sources. Remove the "(currently on Testnet)" and
"(Coming Soon)" labels and the matching frontmatter description. Link
soroswap/aggregator public/mainnet.contracts.json so readers can verify the configuration.

Source Record

Raven recorded this finding as cs-002 (canonical-source, discovered 2026-09-17).

Public source record: improvements/canonical-source/cs-002-soroswap-aggregator-docs-stale-adapter-status.md

Immutable source snapshot: bc09d68c6103

Resolution Handoff

When you deploy a fix, link the resolving issue or pull request to the source record.
Then notify Raven through:

https://github.com/stellar-experimental/stellar-raven/issues/new?template=upstream-improvement-ready.yml&title=%5Bupstream-ready%5D%20cs-002%3A%20

Include the finding ID and the resolving issue or pull request.
Include the deployed version or timestamp. Include the smallest live recheck.
Raven verifies the live surface before it sets the finding to fixed-upstream.
An issue closure or merged pull request does not prove the fix.
A separate reviewer repeats the live check before Raven retires the active finding.
Raven keeps a commit-pinned snapshot when one is available.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading concepts/aggregator.mdx and aggregator/supported-amms.mdx, then compare their adapter-status labels with soroswap/aggregator’s public/mainnet.contracts.json. Update both pages to identify Soroswap, Phoenix, and Aqua/Aquarius as current mainnet sources, remove the stale Testnet and Coming Soon wording and matching frontmatter description, and add the configuration link.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
88/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.