Feature/add sanctum

[Resister-boy]

Pull Request Description

Changes Made

This PR adds the following changes:
This PR contains implentation of interaction with sanctum. The following are the detailed changes:

1. get LST price deployed on Sanctum
2. get LST APY deployed on Sanctum
3. get LST TVL deployed on Sanctum
4. Add liquidity to Sanctum Infinite Pool
5. Remove liquidity from Sanctum Infinite Pool

Basically, I use Sanctum REST API to get LST data or to get unsigned encoded trasaction. The API endpoint is as follows:

Sanctum Stat API

Sanctum Trade API

The following five new tools are included in the PR above:

• SanctumGetPriceTool
• SanctumGetApyTool
• SanctumGetTvlTool
• SanctumAddLiquidityTool
• SanctumRemoveLiquidityTool

Implementation Details

Sanctum get LST Price

    const client = axios.create({
      baseURL: SANCTUM_STAT_API_URI,
    });

    const response = await client.get("/v1/sol-value/current", {
      params: {
        lst: inputs,
      },
      paramsSerializer: (params) => {
        return params.lst.map((value: string) => `lst=${value}`).join("&");
      },
    });

Sanctum get LST APY

    const client = axios.create({
      baseURL: SANCTUM_STAT_API_URI,
    });

    const response = await client.get("/v1/apy/latest", {
      params: {
        lst: inputs,
      },
      paramsSerializer: (params) => {
        return params.lst.map((value: string) => `lst=${value}`).join("&");
      },
    });

Sanctum get LST TVL

    const client = axios.create({
      baseURL: SANCTUM_TRADE_API_URI,
    });

    const response = await client.get("/v1/tvl/current", {
      params: {
        lst: inputs,
      },
      paramsSerializer: (params) => {
        return params.lst.map((value: string) => `lst=${value}`).join("&");
      },
    });

Sanctum add Liquidity

    const client = axios.create({
      baseURL: SANCTUM_TRADE_API_URI,
    });

    const response = await client.post("/v1/liquidity/add", {
      amount,
      dstLstAcc: null,
      lstMint,
      priorityFee: {
        Auto: {
          max_unit_price_micro_lamports: priorityFee,
          unit_limit: 300000,
        },
      },
      quotedAmount,
      signer: agent.wallet.publicKey.toBase58(),
      srcLstAcc: null,
    });

// After get encoded tranaction signature, deserialize the signature and update blockHash. After this sign with agent.wallet and send transaction

Sanctum remove Liquidity

    const client = axios.create({
      baseURL: SANCTUM_TRADE_API_URI,
    });

    const response = await client.post("/v1/liquidity/remove", {
      amount,
      dstLstAcc: null,
      lstMint,
      priorityFee: {
        Auto: {
          max_unit_price_micro_lamports: priorityFee,
          unit_limit: 300000,
        },
      },
      quotedAmount,
      signer: agent.wallet.publicKey.toBase58(),
      srcLstAcc: null,
    });

// After get encoded tranaction signature, deserialize the signature and update blockHash. After this sign with agent.wallet and send transaction

Prompt Used

SanctumGetPriceTool:

const systemPrompt = `
    You are a helpful agent that can interact onchain using the Solana Agent Kit.
    You can fetch prices of the LST(Liquid Staking Token) on the Sanctum`;

const userPrompt = `
    Fetch the price of the LST(Liquid Staking Token) on the Sanctum with following details:

    mints: ["bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1", "7Q2afV64in6N6SeZsAAB81TJzwDoD6zpqmHkzi9Dcavn"]

    After fetching the price of the LST provide the price.
    `;

SanctumGetApyTool:

const systemPrompt = `
    You are a helpful agent that can interact onchain using the Solana Agent Kit.
    You can fetch Apy of the LST(Liquid Staking Token) on the Sanctum`;

const userPrompt = `
    Fetch the APY of the LST(Liquid Staking Token) on the Sanctum with following details:

    mints: ["bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1", "7Q2afV64in6N6SeZsAAB81TJzwDoD6zpqmHkzi9Dcavn"]

    After fetching the APY of the LST provide the APY.
    `;

SanctumGetTvlTool:

const systemPrompt = `
    You are a helpful agent that can interact onchain using the Solana Agent Kit.
    You can fetch TVL of the LST(Liquid Staking Token) on the Sanctum`;

const userPrompt = `
    Fetch the TVL of the LST(Liquid Staking Token) on the Sanctum with following details:

    mints: ["bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1", "7Q2afV64in6N6SeZsAAB81TJzwDoD6zpqmHkzi9Dcavn"]

    After fetching the TVL of the LST provide the TVL.
    `;

SanctumAddLiquidityTool:

  const systemPrompt = `
    You are a helpful agent that can interact onchain using the Solana Agent Kit. 
    You can add liquidity to the Sanctum LST pool
    `;

  const userPrompt = `
    Add liquidity to the Sanctum LST pool:

    lstMint: So11111111111111111111111111111111111111112
    amount: 100000
    quotedAmount: 50000
    priorityFee: 5000

    After adding liquidity, provide the transaction signature.
    `;

SanctumRemoveLiquidityTool:

  const systemPrompt = `
    You are a helpful agent that can interact onchain using the Solana Agent Kit. 
    You can remove liquidity to the Sanctum LST pool
    `;

  const userPrompt = `
    Remvoe liquidity to the Sanctum LST pool:

    lstMint: So11111111111111111111111111111111111111112
    amount: 100000
    quotedAmount: 50000
    priorityFee: 5000

    After removing liquidity, provide the transaction signature.
    `;

Transaction executed by agent

SanctumAddLiquidityTool:

• View Tranaction on Solscan

SanctumRemoveLiquidityTool:

• View Tranaction on Solscan

Other chains do not generate on-chain transactions.

Checklist

• I have tested these changes locally
• I have updated the documentation
• I have added a transaction link
• I have added the prompt used to test it

[Resister-boy]

@thearyanag @michaelessiet As you may know, Sanctum is not deployed on Devnet. All tests were conducted on Mainnet. Please refer to the Solscan link.

[Resister-boy]

@thearyanag @michaelessiet Can review?

[Resister-boy]

@thearyanag @michaelessiet Any feedback plz?

[Copilot]

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