feat: add PumpAmm by kyoshoku · Pull Request #575 · hummingbot/gateway

kyoshoku · 2025-12-17T10:14:09Z

Before submitting this PR, please make sure:

Your code builds clean without any errors or warnings
You are using approved title ("feat/", "fix/", "docs/", "refactor/")

A description of the changes proposed in the pull request:

Tests performed by the developer:

Tips for QA testing:

rapcmia · 2025-12-22T11:34:57Z

Commit 98d03b6

Tested on helius nodeURL
Tested using FRANKLIN/SOL and PUMP/USDC pools

When trying to execute-swap, it kept on failing with these gateway logs for both token pairs ❌

####  /connectors/pumpswap/amm/add-liquidity 
curl -X POST "http://localhost:15888/connectors/pumpswap/amm/add-liquidity" -H "Content-Type: application/json" -d '{"network":"mainnet-beta","walletAddress":"GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV","poolAddress":"2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd","baseTokenAmount":1484.6563846,"quoteTokenAmount":3,"slippagePct":1}' | jq
{
  "statusCode": 400,
  "error": "Error",
  "message": "Transaction simulation failed. This usually means the swap parameters are invalid or market conditions changed. Try again."
}
logs: Program pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA failed: custom program error: 0xbc4 {}

gateway logs

Program log: Instruction: Sell
Program log: AnchorError caused by account: user_base_token_account. Error Code: AccountNotInitialized. Error Number: 3012. Error Message: The program expected this account to be already initialized.
Program pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA consumed 11263 of 299700 compute units
Program pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA failed: custom program error: 0xbc4
    at Solana.simulateTransaction (/home/yawnyunehh/hummingbot/gateway/575/dist/chains/solana/solana.js:1257:23)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async Solana.simulateWithErrorHandling (/home/yawnyunehh/hummingbot/gateway/575/dist/chains/solana/solana.js:1270:13)
    at async executeSwap (/home/yawnyunehh/hummingbot/gateway/575/dist/connectors/pumpswap/amm-routes/executeSwap.js:78:5)
    at async Object.<anonymous> (/home/yawnyunehh/hummingbot/gateway/575/dist/connectors/pumpswap/amm-routes/executeSwap.js:127:20)
2025-12-22 02:42:18 | error | 	Transaction simulation failed. This usually means the swap parameters are invalid or market conditions changed. Try again. {
  "statusCode": 400
} | Error: Transaction simulation failed. This usually means the swap parameters are invalid or market conditions changed. Try again.

Also getting similar behavior with adding liquidity ❌

#### /connectors/pumpswap/amm/add-liquidity
curl -X POST "http://localhost:15888/connectors/pumpswap/amm/add-liquidity" -H "Content-Type: application/json" -d '{"network":"mainnet-beta","walletAddress":"GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV","poolAddress":"8wXzwpLjk6QJMYYC1VHueNnxRVW2nFGvQjgEnV4Mv8sY","baseTokenAmount":883.8117309,"quoteTokenAmount":0.02368971925,"slippagePct":1}' | jq
{
  "statusCode": 400,
  "error": "Error",
  "message": "Transaction simulation failed. This usually means the swap parameters are invalid or market conditions changed. Try again."
}
logs: Program pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA failed: custom program error: 0xbc4

gateway logs

Program log: Instruction: Deposit
Program log: AnchorError caused by account: user_base_token_account. Error Code: AccountNotInitialized. Error Number: 3012. Error Message: The program expected this account to be already initialized.
Program pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA consumed 10358 of 200000 compute units
Program pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA failed: custom program error: 0xbc4
    at Solana.simulateTransaction (/home/yawnyunehh/hummingbot/gateway/575/dist/chains/solana/solana.js:1257:23)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async Solana.simulateWithErrorHandling (/home/yawnyunehh/hummingbot/gateway/575/dist/chains/solana/solana.js:1270:13)
    at async Object.<anonymous> (/home/yawnyunehh/hummingbot/gateway/575/dist/connectors/pumpswap/amm-routes/addLiquidity.js:101:13)
2025-12-22 03:22:23 | error | 	Transaction simulation failed. This usually means the swap parameters are invalid or market conditions changed. Try again. {
  "statusCode": 400
} | Error: Transaction simulation failed. This usually means the swap parameters are invalid or market conditions changed. Try again.

Incase needed, attached test and gateway logs: 12222025.zip

rapcmia · 2025-12-24T06:43:42Z

Commit bfd1b6e

PUMP/USDC 2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd
FRANKLIN/SOL 8wXzwpLjk6QJMYYC1VHueNnxRVW2nFGvQjgEnV4Mv8sY
GET /connectors/pumpswap/amm/pool-info ✅
GET /connectors/pumpswap/amm/quote-swap ✅
POST /connectors/pumpswap/amm/execute-swap ✅
- Buy https://solscan.io/tx/48eqjdY1BETMiEe8ZGJxQ3H1MBwYvSRJ6q51JW7oZSDu2hDeuqBPUsFX8Fu5EAopNHoy7MQSYhs9nCJDZGVnoWb4
- Sell https://solscan.io/tx/55TiftRSoMcQ3JTo5DgLqZx4NMKZ5JMFd3ze3abJuEgyGTXGWYrcASoH1VUFgw5WsNHp2zc7Yzb7aHo4AdEC58Tt
GET /connectors/pumpswap/amm/quote-liquidity ✅

POST /connectors/pumpswap/amm/add-liquidity ✅

curl -X POST "http://localhost:15888/connectors/pumpswap/amm/add-liquidity" -H "Content-Type: application/json" -d '{"network":"mainnet-beta","walletAddress":"GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV","poolAddress":"2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd","baseTokenAmount":1768.818263,"quoteTokenAmount":3,"slippagePct":2}' | jq
{
  "signature": "52qmXDBEga3cEoCV1xT4JTQbzCgDy9yT6LzZf916E9pzKKFbe5PjGgJv9hthUHNXKdPAL2WFQfPmeiVqoxShZnHm",
  "status": 1,
  "data": {
    "fee": 0.000005,
    "baseTokenAmountAdded": 1768.818263,
    "quoteTokenAmountAdded": 2.9999999999305675
  }
}
logs: 2025-12-23 21:54:42 | info | 	Liquidity added successfully: 52qmXDBEga3cEoCV1xT4JTQbzCgDy9yT6LzZf916E9pzKKFbe5PjGgJv9hthUHNXKdPAL2WFQfPmeiVqoxShZnHm

GET /connectors/pumpswap/amm/position-info

When comparing what I added via pumpswap/amm/quote-liquidity, the basTokenAmountAdded and baseTokenAmount does not matched ❌

# add liquidity
curl -X POST "http://localhost:15888/connectors/pumpswap/amm/add-liquidity" -H "Content-Type: application/json" -d '{"network":"mainnet-beta","walletAddress":"GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV","poolAddress":"2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd","baseTokenAmount":1768.818263,"quoteTokenAmount":3,"slippagePct":2}' | jq
{
  "signature": "52qmXDBEga3cEoCV1xT4JTQbzCgDy9yT6LzZf916E9pzKKFbe5PjGgJv9hthUHNXKdPAL2WFQfPmeiVqoxShZnHm",
  "status": 1,
  "data": {
    "fee": 0.000005,
    "baseTokenAmountAdded": 1768.818263,
    "quoteTokenAmountAdded": 2.9999999999305675
  }
}

...

# position info
curl "http://localhost:15888/connectors/pumpswap/amm/position-info?network=mainnet-beta&poolAddress=2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd&walletAddress=GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV" | jq
{
  "poolAddress": "2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd",
  "walletAddress": "GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV",
  "baseTokenAddress": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
  "quoteTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "lpTokenAmount": 0.063388031,
  "baseTokenAmount": 0.0000017709057701118135,
  "quoteTokenAmount": 2.9964724559642188E-9,
  "price": 0.0016920564078206286
}

While the quoteTokenAmount value is close enough, still observed some mismatch

Same behavior occurred on FRANKLIN/SOL pool

"baseTokenAmountAdded": 2384.976761,
"quoteTokenAmountAdded": 0.037501863693916615
...
"baseTokenAmount": 0.0000023849767570914684,
"quoteTokenAmount": 3.7501863632471495E-11,

I tried to compare with raydium-amm and not able to reproduce ✅

"baseTokenAmountAdded": -16.021444000000002,
"quoteTokenAmountAdded": -3
...
"baseTokenAmount": 16.040755158737856,
"quoteTokenAmount": 3.003615982597218,

POST /connectors/pumpswap/amm/remove-liquidity ✅
- Run position-info on all tests and got lptokenamount and zero balances ok

/pools/find/{address} returns no connector/type mapping from GeckoTerminal (dex: pumpswap), it seems pumpswap needs to be included on the list of dex connectors as well ❌

#### /pools/find/2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd?chainNetwork=solana-mainnet-beta
curl "http://localhost:15888/pools/find/2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd?chainNetwork=solana-mainnet-beta" | jq
{"statusCode":400,"error":"BadRequestError","message":"Pool 2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd has no connector/type mapping from GeckoTerminal (dex: pumpswap)"}

I use pump/usdc https://www.geckoterminal.com/solana/pools/2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd

Also observed that pumpswap isn’t routed through the unified /trading/swapendpoints (no mapping in the swap router), so it only works via /connectors/pumpswap/amm/* only ❌

Added test and gateway logs incase needed: 12242025.zip

fengtality · 2025-12-24T15:11:47Z

Since there are no /trading/amm endpoints yet, it's fine if only the /connectors/pumpswap/amm routes work. However, the other issues that @rapcmia should be fixed.

kyoshoku · 2025-12-25T04:45:14Z

Added liquidity amount and fetch position info can be bit different, because amount calculated with pool shares (lpAmount).

rapcmia · 2025-12-25T11:49:15Z

Commit f9aa357

Test on both PUMP/USDC and FRANKLIN/SOL
Observed baseTokenAmount and basetokenAmountAdded values are close enough ✅

/pools/find/{pool address} ✅

curl "http://localhost:15888/pools/find/2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd?chainNetwork=solana-mainnet-beta" | jq
{
  "type": "amm",
  "network": "mainnet-beta",
  "baseSymbol": "PUMP",
  "quoteSymbol": "USDC",
  "baseTokenAddress": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
  "quoteTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "feePct": 0.2,
  "address": "2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd",
  "geckoData": {
    "volumeUsd24h": "851724.342027516",
    "liquidityUsd": "12861945.6608",
    "priceNative": "0.001731955618",
    "priceUsd": "0.00174216228861622658674708785829634536966262390349171281848701735",
    "buys24h": 786,
    "sells24h": 671,
    "timestamp": 1766663628345,
    "apr": 4.834095758739303
  }
}

/pumpswap/amm/add-liquidity ✅

curl -X POST "http://localhost:15888/connectors/pumpswap/amm/add-liquidity" -H "Content-Type: application/json" -d '{"network":"mainnet-beta","walletAddress":"GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV","poolAddress":"2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd","baseTokenAmount":1726.020419,"quoteTokenAmount":3,"slippagePct":2}' | jq
{
  "signature": "24kEcV5WttXyV7QWUmX79jrG42MD6GMMr4UeRRuSoVq4FPUAkzFxWmTYDj23JSz5ngnS9RRuiDXwrUoyE5raZvsG",
  "status": 1,
  "data": {
    "fee": 0.000005,
    "baseTokenAmountAdded": 1726.020419,
    "quoteTokenAmountAdded": 2.9999999995497575
  }
}

/pumpswap/amm/position-info ✅

/connectors/pumpswap/amm/position-info?network=mainnet-beta&poolAddress=2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd&walletAddress=GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV
curl "http://localhost:15888/connectors/pumpswap/amm/position-info?network=mainnet-beta&poolAddress=2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd&walletAddress=GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV" | jq
{
  "poolAddress": "2uF4Xh61rDwxnG9woyxsVQP7zuA6kLFpb3NvnRQeoiSd",
  "walletAddress": "GiooMWkHziPuXhfRar2ChBxU6VhQSrAh7xJTG2zHcxWV",
  "baseTokenAddress": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
  "quoteTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "lpTokenAmount": 0.062603495,
  "baseTokenAmount": 1726.0204163367957,
  "quoteTokenAmount": 2.9999999949208376,
  "price": 0.0017381022649128688
}

Run position-info again for both market pair after we remove liquidity, both return 0 lpTokenAmount ✅

rapcmia

Approved 1/2

Test on linux using gateway connector endpoints
Test on pump/usdc and franklin/sol
GET /connectors/pumpswap/amm/pool-info ok
GET /connectors/pumpswap/amm/position-info ok
GET /connectors/pumpswap/amm/quote-liquidity ok
GET /connectors/pumpswap/amm/quote-swap ok
POST /connectors/pumpswap/amm/execute-swap ok
POST /connectors/pumpswap/amm/add-liquidity ok
POST /connectors/pumpswap/amm/remove-liquidity ok
GET /poolsfind/ ok
Compare responses with txns and each of endpoint response datasets
Reported issues has been addressed by developer
Skipped unified trading endpoints and focus on connector specific

rapcmia · 2025-12-25T12:07:04Z

Thanks for the update, i have added my tests and approved the PR (1/2)

@kyoshoku would you be able to to also check why our github check is failing on this PR?

kyoshoku · 2025-12-26T05:00:59Z

No idea, because those issues are comes from past implementation test cases, not pumpamm

feat: add pumpswap

bff5846

fengtality added this to the v2.12 milestone Dec 18, 2025

fengtality requested review from nikspz and rapcmia December 18, 2025 18:58

Merge branch 'development' into feat/pumpamm

98d03b6

rapcmia added this to Pull Request Board Dec 19, 2025

rapcmia moved this to Under Review in Pull Request Board Dec 19, 2025

rapcmia requested a review from fengtality December 19, 2025 08:37

fengtality added this to Bounties Board Dec 23, 2025

fengtality moved this to Proposed in Bounties Board Dec 23, 2025

kyoshoku changed the title ~~Feat/pumpamm~~ feat: add PumpAmm Dec 24, 2025

fix: ata creation / program account issue

bfd1b6e

fix: find pool and liquidity amount issue

f9aa357

rapcmia approved these changes Dec 25, 2025

View reviewed changes

Merge branch 'development' into feat/pumpamm

d3bda8a

fengtality approved these changes Dec 26, 2025

View reviewed changes

rapcmia added 2 commits January 5, 2026 18:08

Merge branch 'development' into feat/pumpamm

33b9260

Merge branch 'development' into feat/pumpamm

6e73df7

rapcmia moved this from Under Review to Backlog in Pull Request Board Jan 12, 2026

nikspz moved this from Backlog to In Discussion in Pull Request Board Jan 16, 2026

rapcmia removed this from the v2.12 milestone Jan 16, 2026

rapcmia removed this from Pull Request Board Jan 21, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add PumpAmm#575

feat: add PumpAmm#575
kyoshoku wants to merge 7 commits intohummingbot:developmentfrom
kyoshoku:feat/pumpamm

kyoshoku commented Dec 17, 2025

Uh oh!

rapcmia commented Dec 22, 2025

Uh oh!

rapcmia commented Dec 24, 2025

Uh oh!

fengtality commented Dec 24, 2025

Uh oh!

kyoshoku commented Dec 25, 2025

Uh oh!

rapcmia commented Dec 25, 2025 •

edited

Loading

Uh oh!

rapcmia left a comment

Uh oh!

rapcmia commented Dec 25, 2025

Uh oh!

kyoshoku commented Dec 26, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

kyoshoku commented Dec 17, 2025

Uh oh!

rapcmia commented Dec 22, 2025

Uh oh!

rapcmia commented Dec 24, 2025

Uh oh!

fengtality commented Dec 24, 2025

Uh oh!

kyoshoku commented Dec 25, 2025

Uh oh!

rapcmia commented Dec 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rapcmia left a comment

Choose a reason for hiding this comment

Uh oh!

rapcmia commented Dec 25, 2025

Uh oh!

kyoshoku commented Dec 26, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

rapcmia commented Dec 25, 2025 •

edited

Loading