From 3552ffe41c9e501fce783fcc37ca4060ef0c25f2 Mon Sep 17 00:00:00 2001 From: Lautaro Date: Sun, 29 Dec 2024 06:01:19 -0300 Subject: [PATCH 01/10] Fix: change lamports by getting mintInfo --- src/tools/trade.ts | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/src/tools/trade.ts b/src/tools/trade.ts index b42cc2a..0fc3ff0 100644 --- a/src/tools/trade.ts +++ b/src/tools/trade.ts @@ -1,11 +1,10 @@ import { VersionedTransaction, - PublicKey, - LAMPORTS_PER_SOL, + PublicKey } from "@solana/web3.js"; import { SolanaAgentKit } from "../index"; import { TOKENS, DEFAULT_OPTIONS, JUP_API } from "../constants"; - +import { getMint } from "@solana/spl-token"; /** * Swap tokens using Jupiter Exchange * @param agent SolanaAgentKit instance @@ -23,12 +22,17 @@ export async function trade( slippageBps: number = DEFAULT_OPTIONS.SLIPPAGE_BPS, ): Promise { try { + const mintInfo = await getMint(agent.connection, inputMint); + const inputDecimals = mintInfo.decimals; + + // Calculate the correct amount based on actual decimals + const scaledAmount = inputAmount * Math.pow(10, inputDecimals); const quoteResponse = await ( await fetch( `${JUP_API}/quote?` + `inputMint=${inputMint.toString()}` + `&outputMint=${outputMint.toString()}` + - `&amount=${inputAmount * LAMPORTS_PER_SOL}` + + `&amount=${scaledAmount}` + `&slippageBps=${slippageBps}` + `&onlyDirectRoutes=true` + `&maxAccounts=20`, From 984f0390b42da06d08830ab6c550c84645777919 Mon Sep 17 00:00:00 2001 From: aryan Date: Sun, 29 Dec 2024 22:38:10 +0530 Subject: [PATCH 02/10] feat: replit --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 33685e0..4f0831b 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,6 @@ # Solana Agent Kit - - ![Solana Agent Kit Cover 1 (3)](https://github.com/user-attachments/assets/cfa380f6-79d9-474d-9852-3e1976c6de70) @@ -25,6 +23,10 @@ An open-source toolkit for connecting AI agents to Solana protocols. Now, any ag Anyone - whether an SF-based AI researcher or a crypto-native builder - can bring their AI agents trained with any model and seamlessly integrate with Solana. + +[![Run on Repl.it](https://replit.com/badge/github/sendaifun/solana-agent-kit)](https://replit.com/@sendaifun/Solana-Agent-Kit) +> Replit template created by [Arpit Singh](https://github.com/The-x-35) + ## 🔧 Core Blockchain Features - **Token Operations** From 6b9a347f56dda671aeaeb6841286cf92a6649102 Mon Sep 17 00:00:00 2001 From: Lautaro Date: Sun, 29 Dec 2024 16:03:40 -0300 Subject: [PATCH 03/10] Fix: if token is sol --- src/tools/trade.ts | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/src/tools/trade.ts b/src/tools/trade.ts index 0fc3ff0..3704308 100644 --- a/src/tools/trade.ts +++ b/src/tools/trade.ts @@ -22,20 +22,26 @@ export async function trade( slippageBps: number = DEFAULT_OPTIONS.SLIPPAGE_BPS, ): Promise { try { - const mintInfo = await getMint(agent.connection, inputMint); - const inputDecimals = mintInfo.decimals; + // Check if input token is native SOL + const isNativeSol = inputMint.equals(TOKENS.SOL); + + // For native SOL, we use LAMPORTS_PER_SOL, otherwise fetch mint info + const inputDecimals = isNativeSol + ? 9 // SOL always has 9 decimals + : (await getMint(agent.connection, inputMint)).decimals; // Calculate the correct amount based on actual decimals const scaledAmount = inputAmount * Math.pow(10, inputDecimals); + const quoteResponse = await ( await fetch( `${JUP_API}/quote?` + - `inputMint=${inputMint.toString()}` + - `&outputMint=${outputMint.toString()}` + - `&amount=${scaledAmount}` + - `&slippageBps=${slippageBps}` + - `&onlyDirectRoutes=true` + - `&maxAccounts=20`, + `inputMint=${isNativeSol ? TOKENS.SOL.toString() : inputMint.toString()}` + + `&outputMint=${outputMint.toString()}` + + `&amount=${scaledAmount}` + + `&slippageBps=${slippageBps}` + + `&onlyDirectRoutes=true` + + `&maxAccounts=20`, ) ).json(); From 0138f7de898e95b8c249fbbb11bf260eaa961d7b Mon Sep 17 00:00:00 2001 From: Deepak Date: Mon, 30 Dec 2024 02:29:51 +0530 Subject: [PATCH 04/10] Updated README.md with contributors and star graph --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 4f0831b..c917201 100644 --- a/README.md +++ b/README.md @@ -239,6 +239,17 @@ The toolkit relies on several key Solana and Metaplex libraries: Contributions are welcome! Please feel free to submit a Pull Request. Refer to [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines on how to contribute to this project. +## Contributors + + + + + + +## Star History + +[![Star History Chart](https://api.star-history.com/svg?repos=sendaifun/solana-agent-kit&type=Date)](https://star-history.com/#sendaifun/solana-agent-kit&Date) + ## License Apache-2 License From fab1441a0084376711460daeb91b8337638eff1c Mon Sep 17 00:00:00 2001 From: aryan Date: Mon, 30 Dec 2024 03:26:26 +0530 Subject: [PATCH 05/10] chore: docs --- .eslintrc | 2 +- docs/assets/navigation.js | 2 +- docs/assets/search.js | 2 +- docs/classes/SolanaAgentKit.html | 10 +- docs/functions/createSolanaTools.html | 2 +- docs/index.html | 10 +- docs/interfaces/CollectionDeployment.html | 4 +- docs/interfaces/CollectionOptions.html | 4 +- docs/interfaces/Creator.html | 4 +- docs/interfaces/FetchPriceResponse.html | 4 +- docs/interfaces/GibworkCreateTaskReponse.html | 4 +- docs/interfaces/JupiterTokenData.html | 4 +- .../LuloAccountDetailsResponse.html | 4 +- .../interfaces/MintCollectionNFTResponse.html | 4 +- docs/interfaces/PumpFunTokenOptions.html | 4 +- docs/interfaces/PumpfunLaunchResponse.html | 4 +- docs/interfaces/PythFetchPriceResponse.html | 4 +- .../src/agents/readAgent.ts | 1 - examples/persistance-agent/index.ts | 297 +++++++++--------- src/tools/trade.ts | 25 +- 20 files changed, 201 insertions(+), 194 deletions(-) diff --git a/.eslintrc b/.eslintrc index d663169..cfdc5bc 100644 --- a/.eslintrc +++ b/.eslintrc @@ -31,7 +31,7 @@ }, "overrides": [ { - "files": ["test/**/*", "src/utils/keypair.ts"], + "files": ["test/**/*", "src/utils/keypair.ts", "examples/**/*"], "rules": { "no-console": "off" } diff --git a/docs/assets/navigation.js b/docs/assets/navigation.js index 54693ba..12dd419 100644 --- a/docs/assets/navigation.js +++ b/docs/assets/navigation.js @@ -1 +1 @@ -window.navigationData = "data:application/octet-stream;base64,H4sIAAAAAAAAE42TwU7DMAyG3yXniooJJtTbRFUkGDCN3hCHEFwaNXWixBFMaO+O6BCsLPW45OIv3x/ZzuOHIHgnUYgHayTKxSsg3WgSmXCSWlEIZWQIEPJx/aSl3ohMdBpfRHE6u9hmP6ZLawwo0hZLcMZuesA9n0YC30gFIU+BY/HsfJ4U37uvMxyxflOs0oMk69OiXY27XgGpduW1gjUEZzFA0nSIcdIr/fxmfTfEQy1Dt4Zp9RTMBVxHpwl8bTvAUpJMiv9CnHAZjV0oZSNSCSS1CWw7pnEu5FYj/c72rqrZjEmai1jF3jURlzKiall9kjymriIO7eS2N8Gx2g21/1zCNMrJ1bBUu49fW2v2XtxEHBob8gNobJyfbZ8+AWWuiIJlBAAA" \ No newline at end of file +window.navigationData = "data:application/octet-stream;base64,H4sIAAAAAAAAE42TwU4DIRCG34VzY2OjjemtcbMmWrWpezMeEKcuWZYhMEQb03cXt8a6lp164QAf3w/D8PghCN5JzMQDGmnl/BUs3WgSI+Ek1WleGRkChHF//aSm1iSo0fZFzE4nF9vRj+kSjQFFGm0BzuCmTVv2Pm0J/FqqpMyBffHkfJoV37uvMRyxflOs0oMk9HnRbo3bXgKpeum1ghUEl7IgazrEOOmVfn5D33TxUMnQrGBYPQRzAdfR6SSosAFbSJJZ8V+IEy6iwblSGC0VQFKbwJZjGOdCbpNh/7Z3ZcVmDNJcxDK2bh3tQkaralafJY+py2i7cnLdm+FY7YbqfzZhHuXkqmuq3cevEM2vE6e7d4UN4wOob5yebZ8+AWWuiIJlBAAA" \ No newline at end of file diff --git a/docs/assets/search.js b/docs/assets/search.js index 9582149..0e15f57 100644 --- a/docs/assets/search.js +++ b/docs/assets/search.js @@ -1 +1 @@ -window.searchData = "data:application/octet-stream;base64,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"; \ No newline at end of file +window.searchData = "data:application/octet-stream;base64,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"; \ No newline at end of file diff --git a/docs/classes/SolanaAgentKit.html b/docs/classes/SolanaAgentKit.html index e510d32..7886a1b 100644 --- a/docs/classes/SolanaAgentKit.html +++ b/docs/classes/SolanaAgentKit.html @@ -1,7 +1,7 @@ SolanaAgentKit | solana-agent-kit

Class SolanaAgentKit

Main class for interacting with Solana blockchain Provides a unified interface for token operations, NFT management, trading and more

SolanaAgentKit

-

Constructors

constructor +

Constructors

constructor

Properties

connection openai_api_key wallet @@ -39,7 +39,7 @@ Provides a unified interface for token operations, NFT management, trading and m stake trade transfer -

Constructors

constructor

  • new SolanaAgentKit(private_key, rpc_url?, openai_api_key): SolanaAgentKit

  • Parameters

    • private_key: string
    • rpc_url: string = "https://api.mainnet-beta.solana.com"
    • openai_api_key: string

    Returns SolanaAgentKit

Properties

connection

connection: Connection

Solana RPC connection

-

openai_api_key

openai_api_key: string

wallet

wallet: Keypair

Wallet keypair for signing transactions

-

wallet_address

wallet_address: PublicKey

Public key of the wallet

-

Methods

createGibworkTask

  • createGibworkTask(title, content, requirements, tags, tokenMintAddress, tokenAmount, payer?): Promise<GibworkCreateTaskReponse>

  • Parameters

    • title: string
    • content: string
    • requirements: string
    • tags: string[]
    • tokenMintAddress: string
    • tokenAmount: number
    • Optionalpayer: string

    Returns Promise<GibworkCreateTaskReponse>

createOrcaSingleSidedWhirlpool

  • createOrcaSingleSidedWhirlpool(depositTokenAmount, depositTokenMint, otherTokenMint, initialPrice, maxPrice, feeTier): Promise<string>

  • Parameters

    • depositTokenAmount: BN
    • depositTokenMint: PublicKey
    • otherTokenMint: PublicKey
    • initialPrice: Decimal
    • maxPrice: Decimal
    • feeTier:
          | 0.01
          | 0.02
          | 0.04
          | 0.05
          | 0.16
          | 0.3
          | 0.65
          | 1
          | 2

    Returns Promise<string>

createTiplink

  • createTiplink(amount, splmintAddress?): Promise<{
        signature: string;
        url: string;
    }>

  • Parameters

    • amount: number
    • OptionalsplmintAddress: PublicKey

    Returns Promise<{
        signature: string;
        url: string;
    }>

deployCollection

deployToken

  • deployToken(name, uri, symbol, decimals?, initialSupply?): Promise<{
        mint: PublicKey;
    }>

  • Parameters

    • name: string
    • uri: string
    • symbol: string
    • decimals: number = DEFAULT_OPTIONS.TOKEN_DECIMALS
    • OptionalinitialSupply: number

    Returns Promise<{
        mint: PublicKey;
    }>

fetchTokenPrice

  • fetchTokenPrice(mint): Promise<string>

  • Parameters

    • mint: string

    Returns Promise<string>

getAllDomainsTLDs

  • getAllDomainsTLDs(): Promise<String[]>

  • Returns Promise<String[]>

getAllRegisteredAllDomains

  • getAllRegisteredAllDomains(): Promise<string[]>

  • Returns Promise<string[]>

getBalance

  • getBalance(token_address?): Promise<number>

  • Parameters

    • Optionaltoken_address: PublicKey

    Returns Promise<number>

getMainAllDomainsDomain

  • getMainAllDomainsDomain(owner): Promise<null | string>

  • Parameters

    • owner: PublicKey

    Returns Promise<null | string>

getOwnedAllDomains

  • getOwnedAllDomains(owner): Promise<string[]>

  • Parameters

    • owner: PublicKey

    Returns Promise<string[]>

getOwnedDomainsForTLD

  • getOwnedDomainsForTLD(tld): Promise<string[]>

  • Parameters

    • tld: string

    Returns Promise<string[]>

getPrimaryDomain

  • getPrimaryDomain(account): Promise<string>

  • Parameters

    • account: PublicKey

    Returns Promise<string>

getTokenDataByAddress

getTokenDataByTicker

getTPS

launchPumpFunToken

lendAssets

  • lendAssets(amount): Promise<string>

  • Parameters

    • amount: number

    Returns Promise<string>

mintNFT

  • mintNFT(collectionMint, metadata, recipient?): Promise<MintCollectionNFTResponse>

  • Parameters

    • collectionMint: PublicKey
    • metadata: {
          creators?: {
              address: string;
              share: number;
          }[];
          name: string;
          sellerFeeBasisPoints?: number;
          uri: string;
      }
      • Optionalcreators?: {
            address: string;
            share: number;
        }[]
      • name: string
      • OptionalsellerFeeBasisPoints?: number
      • uri: string
    • Optionalrecipient: PublicKey

    Returns Promise<MintCollectionNFTResponse>

openbookCreateMarket

  • openbookCreateMarket(baseMint, quoteMint, lotSize?, tickSize?): Promise<string[]>

  • Parameters

    • baseMint: PublicKey
    • quoteMint: PublicKey
    • lotSize: number = 1
    • tickSize: number = 0.01

    Returns Promise<string[]>

pythFetchPrice

  • pythFetchPrice(priceFeedID): Promise<string>

  • Parameters

    • priceFeedID: string

    Returns Promise<string>

raydiumCreateAmmV4

  • raydiumCreateAmmV4(marketId, baseAmount, quoteAmount, startTime): Promise<string>

  • Parameters

    • marketId: PublicKey
    • baseAmount: BN
    • quoteAmount: BN
    • startTime: BN

    Returns Promise<string>

raydiumCreateClmm

  • raydiumCreateClmm(mint1, mint2, configId, initialPrice, startTime): Promise<string>

  • Parameters

    • mint1: PublicKey
    • mint2: PublicKey
    • configId: PublicKey
    • initialPrice: Decimal
    • startTime: BN

    Returns Promise<string>

raydiumCreateCpmm

  • raydiumCreateCpmm(mint1, mint2, configId, mintAAmount, mintBAmount, startTime): Promise<string>

  • Parameters

    • mint1: PublicKey
    • mint2: PublicKey
    • configId: PublicKey
    • mintAAmount: BN
    • mintBAmount: BN
    • startTime: BN

    Returns Promise<string>

registerDomain

  • registerDomain(name, spaceKB?): Promise<string>

  • Parameters

    • name: string
    • OptionalspaceKB: number

    Returns Promise<string>

requestFaucetFunds

  • requestFaucetFunds(): Promise<string>

  • Returns Promise<string>

resolveAllDomains

  • resolveAllDomains(domain): Promise<undefined | PublicKey>

  • Parameters

    • domain: string

    Returns Promise<undefined | PublicKey>

resolveSolDomain

  • resolveSolDomain(domain): Promise<PublicKey>

  • Parameters

    • domain: string

    Returns Promise<PublicKey>

rockPaperScissors

  • rockPaperScissors(amount, choice): Promise<string>

  • Parameters

    • amount: number
    • choice: "rock" | "paper" | "scissors"

    Returns Promise<string>

sendCompressedAirdrop

  • sendCompressedAirdrop(mintAddress, amount, decimals, recipients, priorityFeeInLamports, shouldLog): Promise<string[]>

  • Parameters

    • mintAddress: string
    • amount: number
    • decimals: number
    • recipients: string[]
    • priorityFeeInLamports: number
    • shouldLog: boolean

    Returns Promise<string[]>

stake

  • stake(amount): Promise<string>

  • Parameters

    • amount: number

    Returns Promise<string>

trade

  • trade(outputMint, inputAmount, inputMint?, slippageBps?): Promise<string>

  • Parameters

    • outputMint: PublicKey
    • inputAmount: number
    • OptionalinputMint: PublicKey
    • slippageBps: number = DEFAULT_OPTIONS.SLIPPAGE_BPS

    Returns Promise<string>

transfer

  • transfer(to, amount, mint?): Promise<string>

  • Parameters

    • to: PublicKey
    • amount: number
    • Optionalmint: PublicKey

    Returns Promise<string>

Settings

Member Visibility

On This Page

Constructors
Properties
Methods
+

Constructors

constructor

  • new SolanaAgentKit(private_key, rpc_url?, openai_api_key): SolanaAgentKit

  • Parameters

    • private_key: string
    • rpc_url: string = "https://api.mainnet-beta.solana.com"
    • openai_api_key: string

    Returns SolanaAgentKit

Properties

connection

connection: Connection

Solana RPC connection

+

openai_api_key

openai_api_key: string

wallet

wallet: Keypair

Wallet keypair for signing transactions

+

wallet_address

wallet_address: PublicKey

Public key of the wallet

+

Methods

createGibworkTask

  • createGibworkTask(title, content, requirements, tags, tokenMintAddress, tokenAmount, payer?): Promise<GibworkCreateTaskReponse>

  • Parameters

    • title: string
    • content: string
    • requirements: string
    • tags: string[]
    • tokenMintAddress: string
    • tokenAmount: number
    • Optionalpayer: string

    Returns Promise<GibworkCreateTaskReponse>

createOrcaSingleSidedWhirlpool

  • createOrcaSingleSidedWhirlpool(depositTokenAmount, depositTokenMint, otherTokenMint, initialPrice, maxPrice, feeTier): Promise<string>

  • Parameters

    • depositTokenAmount: BN
    • depositTokenMint: PublicKey
    • otherTokenMint: PublicKey
    • initialPrice: Decimal
    • maxPrice: Decimal
    • feeTier:
          | 0.01
          | 0.02
          | 0.04
          | 0.05
          | 0.16
          | 0.3
          | 0.65
          | 1
          | 2

    Returns Promise<string>

createTiplink

  • createTiplink(amount, splmintAddress?): Promise<{
        signature: string;
        url: string;
    }>

  • Parameters

    • amount: number
    • OptionalsplmintAddress: PublicKey

    Returns Promise<{
        signature: string;
        url: string;
    }>

deployCollection

deployToken

  • deployToken(name, uri, symbol, decimals?, initialSupply?): Promise<{
        mint: PublicKey;
    }>

  • Parameters

    • name: string
    • uri: string
    • symbol: string
    • decimals: number = DEFAULT_OPTIONS.TOKEN_DECIMALS
    • OptionalinitialSupply: number

    Returns Promise<{
        mint: PublicKey;
    }>

fetchTokenPrice

  • fetchTokenPrice(mint): Promise<string>

  • Parameters

    • mint: string

    Returns Promise<string>

getAllDomainsTLDs

  • getAllDomainsTLDs(): Promise<String[]>

  • Returns Promise<String[]>

getAllRegisteredAllDomains

  • getAllRegisteredAllDomains(): Promise<string[]>

  • Returns Promise<string[]>

getBalance

  • getBalance(token_address?): Promise<number>

  • Parameters

    • Optionaltoken_address: PublicKey

    Returns Promise<number>

getMainAllDomainsDomain

  • getMainAllDomainsDomain(owner): Promise<null | string>

  • Parameters

    • owner: PublicKey

    Returns Promise<null | string>

getOwnedAllDomains

  • getOwnedAllDomains(owner): Promise<string[]>

  • Parameters

    • owner: PublicKey

    Returns Promise<string[]>

getOwnedDomainsForTLD

  • getOwnedDomainsForTLD(tld): Promise<string[]>

  • Parameters

    • tld: string

    Returns Promise<string[]>

getPrimaryDomain

  • getPrimaryDomain(account): Promise<string>

  • Parameters

    • account: PublicKey

    Returns Promise<string>

getTokenDataByAddress

getTokenDataByTicker

getTPS

launchPumpFunToken

lendAssets

  • lendAssets(amount): Promise<string>

  • Parameters

    • amount: number

    Returns Promise<string>

mintNFT

  • mintNFT(collectionMint, metadata, recipient?): Promise<MintCollectionNFTResponse>

  • Parameters

    • collectionMint: PublicKey
    • metadata: {
          creators?: {
              address: string;
              share: number;
          }[];
          name: string;
          sellerFeeBasisPoints?: number;
          uri: string;
      }
      • Optionalcreators?: {
            address: string;
            share: number;
        }[]
      • name: string
      • OptionalsellerFeeBasisPoints?: number
      • uri: string
    • Optionalrecipient: PublicKey

    Returns Promise<MintCollectionNFTResponse>

openbookCreateMarket

  • openbookCreateMarket(baseMint, quoteMint, lotSize?, tickSize?): Promise<string[]>

  • Parameters

    • baseMint: PublicKey
    • quoteMint: PublicKey
    • lotSize: number = 1
    • tickSize: number = 0.01

    Returns Promise<string[]>

pythFetchPrice

  • pythFetchPrice(priceFeedID): Promise<string>

  • Parameters

    • priceFeedID: string

    Returns Promise<string>

raydiumCreateAmmV4

  • raydiumCreateAmmV4(marketId, baseAmount, quoteAmount, startTime): Promise<string>

  • Parameters

    • marketId: PublicKey
    • baseAmount: BN
    • quoteAmount: BN
    • startTime: BN

    Returns Promise<string>

raydiumCreateClmm

  • raydiumCreateClmm(mint1, mint2, configId, initialPrice, startTime): Promise<string>

  • Parameters

    • mint1: PublicKey
    • mint2: PublicKey
    • configId: PublicKey
    • initialPrice: Decimal
    • startTime: BN

    Returns Promise<string>

raydiumCreateCpmm

  • raydiumCreateCpmm(mint1, mint2, configId, mintAAmount, mintBAmount, startTime): Promise<string>

  • Parameters

    • mint1: PublicKey
    • mint2: PublicKey
    • configId: PublicKey
    • mintAAmount: BN
    • mintBAmount: BN
    • startTime: BN

    Returns Promise<string>

registerDomain

  • registerDomain(name, spaceKB?): Promise<string>

  • Parameters

    • name: string
    • OptionalspaceKB: number

    Returns Promise<string>

requestFaucetFunds

  • requestFaucetFunds(): Promise<string>

  • Returns Promise<string>

resolveAllDomains

  • resolveAllDomains(domain): Promise<undefined | PublicKey>

  • Parameters

    • domain: string

    Returns Promise<undefined | PublicKey>

resolveSolDomain

  • resolveSolDomain(domain): Promise<PublicKey>

  • Parameters

    • domain: string

    Returns Promise<PublicKey>

rockPaperScissors

  • rockPaperScissors(amount, choice): Promise<string>

  • Parameters

    • amount: number
    • choice: "rock" | "paper" | "scissors"

    Returns Promise<string>

sendCompressedAirdrop

  • sendCompressedAirdrop(mintAddress, amount, decimals, recipients, priorityFeeInLamports, shouldLog): Promise<string[]>

  • Parameters

    • mintAddress: string
    • amount: number
    • decimals: number
    • recipients: string[]
    • priorityFeeInLamports: number
    • shouldLog: boolean

    Returns Promise<string[]>

stake

  • stake(amount): Promise<string>

  • Parameters

    • amount: number

    Returns Promise<string>

trade

  • trade(outputMint, inputAmount, inputMint?, slippageBps?): Promise<string>

  • Parameters

    • outputMint: PublicKey
    • inputAmount: number
    • OptionalinputMint: PublicKey
    • slippageBps: number = DEFAULT_OPTIONS.SLIPPAGE_BPS

    Returns Promise<string>

transfer

  • transfer(to, amount, mint?): Promise<string>

  • Parameters

    • to: PublicKey
    • amount: number
    • Optionalmint: PublicKey

    Returns Promise<string>

Settings

Member Visibility

On This Page

Constructors
Properties
Methods
diff --git a/docs/functions/createSolanaTools.html b/docs/functions/createSolanaTools.html index 8527902..920c02c 100644 --- a/docs/functions/createSolanaTools.html +++ b/docs/functions/createSolanaTools.html @@ -1 +1 @@ -createSolanaTools | solana-agent-kit

Function createSolanaTools

  • createSolanaTools(solanaKit): (
        | SolanaBalanceTool
        | SolanaTransferTool
        | SolanaDeployTokenTool
        | SolanaDeployCollectionTool
        | SolanaMintNFTTool
        | SolanaTradeTool
        | SolanaRequestFundsTool
        | SolanaRegisterDomainTool
        | SolanaResolveDomainTool
        | SolanaGetDomainTool
        | SolanaGetWalletAddressTool
        | SolanaPumpfunTokenLaunchTool
        | SolanaCreateImageTool
        | SolanaLendAssetTool
        | SolanaTPSCalculatorTool
        | SolanaStakeTool
        | SolanaFetchPriceTool
        | SolanaTokenDataTool
        | SolanaTokenDataByTickerTool
        | SolanaCompressedAirdropTool
        | SolanaCreateSingleSidedWhirlpoolTool
        | SolanaRaydiumCreateAmmV4
        | SolanaRaydiumCreateClmm
        | SolanaRaydiumCreateCpmm
        | SolanaOpenbookCreateMarket
        | SolanaPythFetchPrice
        | SolanaResolveAllDomainsTool
        | SolanaGetOwnedDomains
        | SolanaGetOwnedTldDomains
        | SolanaGetAllTlds
        | SolanaGetMainDomain
        | SolanaCreateGibworkTask
        | SolanaRockPaperScissorsTool
        | SolanaTipLinkTool)[]

  • Parameters

    Returns (
        | SolanaBalanceTool
        | SolanaTransferTool
        | SolanaDeployTokenTool
        | SolanaDeployCollectionTool
        | SolanaMintNFTTool
        | SolanaTradeTool
        | SolanaRequestFundsTool
        | SolanaRegisterDomainTool
        | SolanaResolveDomainTool
        | SolanaGetDomainTool
        | SolanaGetWalletAddressTool
        | SolanaPumpfunTokenLaunchTool
        | SolanaCreateImageTool
        | SolanaLendAssetTool
        | SolanaTPSCalculatorTool
        | SolanaStakeTool
        | SolanaFetchPriceTool
        | SolanaTokenDataTool
        | SolanaTokenDataByTickerTool
        | SolanaCompressedAirdropTool
        | SolanaCreateSingleSidedWhirlpoolTool
        | SolanaRaydiumCreateAmmV4
        | SolanaRaydiumCreateClmm
        | SolanaRaydiumCreateCpmm
        | SolanaOpenbookCreateMarket
        | SolanaPythFetchPrice
        | SolanaResolveAllDomainsTool
        | SolanaGetOwnedDomains
        | SolanaGetOwnedTldDomains
        | SolanaGetAllTlds
        | SolanaGetMainDomain
        | SolanaCreateGibworkTask
        | SolanaRockPaperScissorsTool
        | SolanaTipLinkTool)[]

Settings

Member Visibility
+createSolanaTools | solana-agent-kit

Function createSolanaTools

  • createSolanaTools(solanaKit): (
        | SolanaBalanceTool
        | SolanaTransferTool
        | SolanaDeployTokenTool
        | SolanaDeployCollectionTool
        | SolanaMintNFTTool
        | SolanaTradeTool
        | SolanaRequestFundsTool
        | SolanaRegisterDomainTool
        | SolanaResolveDomainTool
        | SolanaGetDomainTool
        | SolanaGetWalletAddressTool
        | SolanaPumpfunTokenLaunchTool
        | SolanaCreateImageTool
        | SolanaLendAssetTool
        | SolanaTPSCalculatorTool
        | SolanaStakeTool
        | SolanaFetchPriceTool
        | SolanaTokenDataTool
        | SolanaTokenDataByTickerTool
        | SolanaCompressedAirdropTool
        | SolanaCreateSingleSidedWhirlpoolTool
        | SolanaRaydiumCreateAmmV4
        | SolanaRaydiumCreateClmm
        | SolanaRaydiumCreateCpmm
        | SolanaOpenbookCreateMarket
        | SolanaPythFetchPrice
        | SolanaResolveAllDomainsTool
        | SolanaGetOwnedDomains
        | SolanaGetOwnedTldDomains
        | SolanaGetAllTlds
        | SolanaGetMainDomain
        | SolanaCreateGibworkTask
        | SolanaRockPaperScissorsTool
        | SolanaTipLinkTool)[]

  • Parameters

    Returns (
        | SolanaBalanceTool
        | SolanaTransferTool
        | SolanaDeployTokenTool
        | SolanaDeployCollectionTool
        | SolanaMintNFTTool
        | SolanaTradeTool
        | SolanaRequestFundsTool
        | SolanaRegisterDomainTool
        | SolanaResolveDomainTool
        | SolanaGetDomainTool
        | SolanaGetWalletAddressTool
        | SolanaPumpfunTokenLaunchTool
        | SolanaCreateImageTool
        | SolanaLendAssetTool
        | SolanaTPSCalculatorTool
        | SolanaStakeTool
        | SolanaFetchPriceTool
        | SolanaTokenDataTool
        | SolanaTokenDataByTickerTool
        | SolanaCompressedAirdropTool
        | SolanaCreateSingleSidedWhirlpoolTool
        | SolanaRaydiumCreateAmmV4
        | SolanaRaydiumCreateClmm
        | SolanaRaydiumCreateCpmm
        | SolanaOpenbookCreateMarket
        | SolanaPythFetchPrice
        | SolanaResolveAllDomainsTool
        | SolanaGetOwnedDomains
        | SolanaGetOwnedTldDomains
        | SolanaGetAllTlds
        | SolanaGetMainDomain
        | SolanaCreateGibworkTask
        | SolanaRockPaperScissorsTool
        | SolanaTipLinkTool)[]

Settings

Member Visibility
diff --git a/docs/index.html b/docs/index.html index 103722a..b165d1c 100644 --- a/docs/index.html +++ b/docs/index.html @@ -15,6 +15,10 @@
  • And more...

    • Anyone - whether an SF-based AI researcher or a crypto-native builder - can bring their AI agents trained with any model and seamlessly integrate with Solana.

    +

    Run on Repl.it

    +
    +

    Replit template created by Arpit Singh

    +

    🔧 Core Blockchain Features

    • Token Operations

      @@ -149,6 +153,10 @@

    Contributing

    Contributions are welcome! Please feel free to submit a Pull Request. Refer to CONTRIBUTING.md for detailed guidelines on how to contribute to this project.

    +

    Contributors

    + + +

    Star History

    Star History Chart

    License

    Apache-2 License

    Security

    This toolkit handles private keys and transactions. Always ensure you're using it in a secure environment and never share your private keys.

    -

    Settings

    Member Visibility

    On This Page

    Solana Agent Kit
    +

    Settings

    Member Visibility

    On This Page

    Solana Agent Kit
    diff --git a/docs/interfaces/CollectionDeployment.html b/docs/interfaces/CollectionDeployment.html index 47a2904..67ac5bb 100644 --- a/docs/interfaces/CollectionDeployment.html +++ b/docs/interfaces/CollectionDeployment.html @@ -1,3 +1,3 @@ -CollectionDeployment | solana-agent-kit

    Interface CollectionDeployment

    interface CollectionDeployment {
        collectionAddress: PublicKey;
        signature: Uint8Array<ArrayBufferLike>;
    }

    Properties

    collectionAddress +CollectionDeployment | solana-agent-kit

    Interface CollectionDeployment

    interface CollectionDeployment {
        collectionAddress: PublicKey;
        signature: Uint8Array<ArrayBufferLike>;
    }

    Properties

    collectionAddress signature -

    Properties

    collectionAddress

    collectionAddress: PublicKey

    signature

    signature: Uint8Array<ArrayBufferLike>

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    collectionAddress

    collectionAddress: PublicKey

    signature

    signature: Uint8Array<ArrayBufferLike>

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/CollectionOptions.html b/docs/interfaces/CollectionOptions.html index c67eddd..1aed17f 100644 --- a/docs/interfaces/CollectionOptions.html +++ b/docs/interfaces/CollectionOptions.html @@ -1,5 +1,5 @@ -CollectionOptions | solana-agent-kit

    Interface CollectionOptions

    interface CollectionOptions {
        creators?: Creator[];
        name: string;
        royaltyBasisPoints?: number;
        uri: string;
    }

    Properties

    creators? +CollectionOptions | solana-agent-kit

    Interface CollectionOptions

    interface CollectionOptions {
        creators?: Creator[];
        name: string;
        royaltyBasisPoints?: number;
        uri: string;
    }

    Properties

    creators? name royaltyBasisPoints? uri -

    Properties

    Optionalcreators

    creators?: Creator[]

    name

    name: string

    OptionalroyaltyBasisPoints

    royaltyBasisPoints?: number

    uri

    uri: string

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    Optionalcreators

    creators?: Creator[]

    name

    name: string

    OptionalroyaltyBasisPoints

    royaltyBasisPoints?: number

    uri

    uri: string

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/Creator.html b/docs/interfaces/Creator.html index 14a20c1..628c6c3 100644 --- a/docs/interfaces/Creator.html +++ b/docs/interfaces/Creator.html @@ -1,3 +1,3 @@ -Creator | solana-agent-kit

    Interface Creator

    interface Creator {
        address: string;
        percentage: number;
    }

    Properties

    address +Creator | solana-agent-kit

    Interface Creator

    interface Creator {
        address: string;
        percentage: number;
    }

    Properties

    address percentage -

    Properties

    address

    address: string

    percentage

    percentage: number

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    address

    address: string

    percentage

    percentage: number

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/FetchPriceResponse.html b/docs/interfaces/FetchPriceResponse.html index 65a55ee..af9dd93 100644 --- a/docs/interfaces/FetchPriceResponse.html +++ b/docs/interfaces/FetchPriceResponse.html @@ -1,6 +1,6 @@ -FetchPriceResponse | solana-agent-kit

    Interface FetchPriceResponse

    interface FetchPriceResponse {
        code?: string;
        message?: string;
        priceInUSDC?: string;
        status: "success" | "error";
        tokenId?: string;
    }

    Properties

    code? +FetchPriceResponse | solana-agent-kit

    Interface FetchPriceResponse

    interface FetchPriceResponse {
        code?: string;
        message?: string;
        priceInUSDC?: string;
        status: "success" | "error";
        tokenId?: string;
    }

    Properties

    code? message? priceInUSDC? status tokenId? -

    Properties

    Optionalcode

    code?: string

    Optionalmessage

    message?: string

    OptionalpriceInUSDC

    priceInUSDC?: string

    status

    status: "success" | "error"

    OptionaltokenId

    tokenId?: string

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    Optionalcode

    code?: string

    Optionalmessage

    message?: string

    OptionalpriceInUSDC

    priceInUSDC?: string

    status

    status: "success" | "error"

    OptionaltokenId

    tokenId?: string

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/GibworkCreateTaskReponse.html b/docs/interfaces/GibworkCreateTaskReponse.html index 321f48a..a2cb5e1 100644 --- a/docs/interfaces/GibworkCreateTaskReponse.html +++ b/docs/interfaces/GibworkCreateTaskReponse.html @@ -1,4 +1,4 @@ -GibworkCreateTaskReponse | solana-agent-kit

    Interface GibworkCreateTaskReponse

    interface GibworkCreateTaskReponse {
        signature?: string;
        status: "success" | "error";
        taskId?: string;
    }

    Properties

    signature? +GibworkCreateTaskReponse | solana-agent-kit

    Interface GibworkCreateTaskReponse

    interface GibworkCreateTaskReponse {
        signature?: string;
        status: "success" | "error";
        taskId?: string;
    }

    Properties

    signature? status taskId? -

    Properties

    Optionalsignature

    signature?: string

    status

    status: "success" | "error"

    OptionaltaskId

    taskId?: string

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    Optionalsignature

    signature?: string

    status

    status: "success" | "error"

    OptionaltaskId

    taskId?: string

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/JupiterTokenData.html b/docs/interfaces/JupiterTokenData.html index 4528c80..d86a876 100644 --- a/docs/interfaces/JupiterTokenData.html +++ b/docs/interfaces/JupiterTokenData.html @@ -1,4 +1,4 @@ -JupiterTokenData | solana-agent-kit

    Interface JupiterTokenData

    interface JupiterTokenData {
        address: string;
        daily_volume: number;
        decimals: number;
        extensions: {
            coingeckoId?: string;
        };
        freeze_authority: null | string;
        logoURI: string;
        mint_authority: null | string;
        name: string;
        permanent_delegate: null | string;
        symbol: string;
        tags: string[];
    }

    Properties

    address +JupiterTokenData | solana-agent-kit

    Interface JupiterTokenData

    interface JupiterTokenData {
        address: string;
        daily_volume: number;
        decimals: number;
        extensions: {
            coingeckoId?: string;
        };
        freeze_authority: null | string;
        logoURI: string;
        mint_authority: null | string;
        name: string;
        permanent_delegate: null | string;
        symbol: string;
        tags: string[];
    }

    Properties

    address daily_volume decimals extensions @@ -9,4 +9,4 @@ permanent_delegate symbol tags -

    Properties

    address

    address: string

    daily_volume

    daily_volume: number

    decimals

    decimals: number

    extensions

    extensions: {
        coingeckoId?: string;
    }

    freeze_authority

    freeze_authority: null | string

    logoURI

    logoURI: string

    mint_authority

    mint_authority: null | string

    name

    name: string

    permanent_delegate

    permanent_delegate: null | string

    symbol

    symbol: string

    tags

    tags: string[]

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    address

    address: string

    daily_volume

    daily_volume: number

    decimals

    decimals: number

    extensions

    extensions: {
        coingeckoId?: string;
    }

    freeze_authority

    freeze_authority: null | string

    logoURI

    logoURI: string

    mint_authority

    mint_authority: null | string

    name

    name: string

    permanent_delegate

    permanent_delegate: null | string

    symbol

    symbol: string

    tags

    tags: string[]

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/LuloAccountDetailsResponse.html b/docs/interfaces/LuloAccountDetailsResponse.html index 381c57b..bca23ab 100644 --- a/docs/interfaces/LuloAccountDetailsResponse.html +++ b/docs/interfaces/LuloAccountDetailsResponse.html @@ -1,6 +1,6 @@ LuloAccountDetailsResponse | solana-agent-kit

    Interface LuloAccountDetailsResponse

    Lulo Account Details response format

    -
    interface LuloAccountDetailsResponse {
        interestEarned: number;
        realtimeApy: number;
        settings: {
            allowedProtocols: null | string;
            homebase: null | string;
            minimumRate: string;
            owner: string;
        };
        totalValue: number;
    }

    Properties

    interestEarned +
    interface LuloAccountDetailsResponse {
        interestEarned: number;
        realtimeApy: number;
        settings: {
            allowedProtocols: null | string;
            homebase: null | string;
            minimumRate: string;
            owner: string;
        };
        totalValue: number;
    }

    Properties

    interestEarned realtimeApy settings totalValue -

    Properties

    interestEarned

    interestEarned: number

    realtimeApy

    realtimeApy: number

    settings

    settings: {
        allowedProtocols: null | string;
        homebase: null | string;
        minimumRate: string;
        owner: string;
    }

    totalValue

    totalValue: number

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    interestEarned

    interestEarned: number

    realtimeApy

    realtimeApy: number

    settings

    settings: {
        allowedProtocols: null | string;
        homebase: null | string;
        minimumRate: string;
        owner: string;
    }

    totalValue

    totalValue: number

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/MintCollectionNFTResponse.html b/docs/interfaces/MintCollectionNFTResponse.html index c1d93d3..791d8ee 100644 --- a/docs/interfaces/MintCollectionNFTResponse.html +++ b/docs/interfaces/MintCollectionNFTResponse.html @@ -1,3 +1,3 @@ -MintCollectionNFTResponse | solana-agent-kit

    Interface MintCollectionNFTResponse

    interface MintCollectionNFTResponse {
        metadata: PublicKey;
        mint: PublicKey;
    }

    Properties

    metadata +MintCollectionNFTResponse | solana-agent-kit

    Interface MintCollectionNFTResponse

    interface MintCollectionNFTResponse {
        metadata: PublicKey;
        mint: PublicKey;
    }

    Properties

    metadata mint -

    Properties

    metadata

    metadata: PublicKey

    mint

    mint: PublicKey

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    metadata

    metadata: PublicKey

    mint

    mint: PublicKey

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/PumpFunTokenOptions.html b/docs/interfaces/PumpFunTokenOptions.html index ab335a7..b1eefb8 100644 --- a/docs/interfaces/PumpFunTokenOptions.html +++ b/docs/interfaces/PumpFunTokenOptions.html @@ -1,7 +1,7 @@ -PumpFunTokenOptions | solana-agent-kit

    Interface PumpFunTokenOptions

    interface PumpFunTokenOptions {
        initialLiquiditySOL?: number;
        priorityFee?: number;
        slippageBps?: number;
        telegram?: string;
        twitter?: string;
        website?: string;
    }

    Properties

    initialLiquiditySOL? +PumpFunTokenOptions | solana-agent-kit

    Interface PumpFunTokenOptions

    interface PumpFunTokenOptions {
        initialLiquiditySOL?: number;
        priorityFee?: number;
        slippageBps?: number;
        telegram?: string;
        twitter?: string;
        website?: string;
    }

    Properties

    initialLiquiditySOL? priorityFee? slippageBps? telegram? twitter? website? -

    Properties

    OptionalinitialLiquiditySOL

    initialLiquiditySOL?: number

    OptionalpriorityFee

    priorityFee?: number

    OptionalslippageBps

    slippageBps?: number

    Optionaltelegram

    telegram?: string

    Optionaltwitter

    twitter?: string

    Optionalwebsite

    website?: string

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    OptionalinitialLiquiditySOL

    initialLiquiditySOL?: number

    OptionalpriorityFee

    priorityFee?: number

    OptionalslippageBps

    slippageBps?: number

    Optionaltelegram

    telegram?: string

    Optionaltwitter

    twitter?: string

    Optionalwebsite

    website?: string

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/PumpfunLaunchResponse.html b/docs/interfaces/PumpfunLaunchResponse.html index 3c4f081..0ed5c95 100644 --- a/docs/interfaces/PumpfunLaunchResponse.html +++ b/docs/interfaces/PumpfunLaunchResponse.html @@ -1,5 +1,5 @@ -PumpfunLaunchResponse | solana-agent-kit

    Interface PumpfunLaunchResponse

    interface PumpfunLaunchResponse {
        error?: string;
        metadataUri?: string;
        mint: string;
        signature: string;
    }

    Properties

    error? +PumpfunLaunchResponse | solana-agent-kit

    Interface PumpfunLaunchResponse

    interface PumpfunLaunchResponse {
        error?: string;
        metadataUri?: string;
        mint: string;
        signature: string;
    }

    Properties

    error? metadataUri? mint signature -

    Properties

    Optionalerror

    error?: string

    OptionalmetadataUri

    metadataUri?: string

    mint

    mint: string

    signature

    signature: string

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    Optionalerror

    error?: string

    OptionalmetadataUri

    metadataUri?: string

    mint

    mint: string

    signature

    signature: string

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/docs/interfaces/PythFetchPriceResponse.html b/docs/interfaces/PythFetchPriceResponse.html index 7d2c8ff..b01fb14 100644 --- a/docs/interfaces/PythFetchPriceResponse.html +++ b/docs/interfaces/PythFetchPriceResponse.html @@ -1,6 +1,6 @@ -PythFetchPriceResponse | solana-agent-kit

    Interface PythFetchPriceResponse

    interface PythFetchPriceResponse {
        code?: string;
        message?: string;
        price?: string;
        priceFeedID: string;
        status: "success" | "error";
    }

    Properties

    code? +PythFetchPriceResponse | solana-agent-kit

    Interface PythFetchPriceResponse

    interface PythFetchPriceResponse {
        code?: string;
        message?: string;
        price?: string;
        priceFeedID: string;
        status: "success" | "error";
    }

    Properties

    code? message? price? priceFeedID status -

    Properties

    Optionalcode

    code?: string

    Optionalmessage

    message?: string

    Optionalprice

    price?: string

    priceFeedID

    priceFeedID: string

    status

    status: "success" | "error"

    Settings

    Member Visibility

    On This Page

    Properties
    +

    Properties

    Optionalcode

    code?: string

    Optionalmessage

    message?: string

    Optionalprice

    price?: string

    priceFeedID

    priceFeedID: string

    status

    status: "success" | "error"

    Settings

    Member Visibility

    On This Page

    Properties
    diff --git a/examples/agent-kit-langgraph/src/agents/readAgent.ts b/examples/agent-kit-langgraph/src/agents/readAgent.ts index 7875c54..957434f 100644 --- a/examples/agent-kit-langgraph/src/agents/readAgent.ts +++ b/examples/agent-kit-langgraph/src/agents/readAgent.ts @@ -1,7 +1,6 @@ import { createReactAgent } from "@langchain/langgraph/prebuilt"; import { gpt4o } from "../utils/model"; import { solanaAgentState } from "../utils/state"; -import { HumanMessage } from "@langchain/core/messages"; import { agentKit } from "../utils/solanaAgent"; import { SolanaBalanceTool, diff --git a/examples/persistance-agent/index.ts b/examples/persistance-agent/index.ts index 21badd0..9ea1931 100644 --- a/examples/persistance-agent/index.ts +++ b/examples/persistance-agent/index.ts @@ -8,27 +8,30 @@ import * as readline from "readline"; import { PostgresSaver } from "@langchain/langgraph-checkpoint-postgres"; dotenv.config(); -const checkpointer = PostgresSaver.fromConnString( - process.env.POSTGRES_DB_URL! -); +const checkpointer = PostgresSaver.fromConnString(process.env.POSTGRES_DB_URL!); function validateEnvironment(): void { - const missingVars: string[] = []; - const requiredVars = ["OPENAI_API_KEY", "RPC_URL", "SOLANA_PRIVATE_KEY", "POSTGRES_DB_URL"]; + const missingVars: string[] = []; + const requiredVars = [ + "OPENAI_API_KEY", + "RPC_URL", + "SOLANA_PRIVATE_KEY", + "POSTGRES_DB_URL", + ]; - requiredVars.forEach((varName) => { - if (!process.env[varName]) { - missingVars.push(varName); - } - }); - - if (missingVars.length > 0) { - console.error("Error: Required environment variables are not set"); - missingVars.forEach((varName) => { - console.error(`${varName}=your_${varName.toLowerCase()}_here`); - }); - process.exit(1); + requiredVars.forEach((varName) => { + if (!process.env[varName]) { + missingVars.push(varName); } + }); + + if (missingVars.length > 0) { + console.error("Error: Required environment variables are not set"); + missingVars.forEach((varName) => { + console.error(`${varName}=your_${varName.toLowerCase()}_here`); + }); + process.exit(1); + } } validateEnvironment(); @@ -36,37 +39,37 @@ validateEnvironment(); const WALLET_DATA_FILE = "wallet_data.txt"; async function initializeAgent() { - try { - const llm = new ChatOpenAI({ - modelName: "gpt-4o-mini", - temperature: 0.7, - }); + try { + const llm = new ChatOpenAI({ + modelName: "gpt-4o-mini", + temperature: 0.7, + }); - let walletDataStr: string | null = null; + let walletDataStr: string | null = null; - if (fs.existsSync(WALLET_DATA_FILE)) { - try { - walletDataStr = fs.readFileSync(WALLET_DATA_FILE, "utf8"); - } catch (error) { - console.error("Error reading wallet data:", error); - } - } + if (fs.existsSync(WALLET_DATA_FILE)) { + try { + walletDataStr = fs.readFileSync(WALLET_DATA_FILE, "utf8"); + } catch (error) { + console.error("Error reading wallet data:", error); + } + } - const solanaAgent = new SolanaAgentKit( - process.env.SOLANA_PRIVATE_KEY!, - process.env.RPC_URL, - process.env.OPENAI_API_KEY!, - ); + const solanaAgent = new SolanaAgentKit( + process.env.SOLANA_PRIVATE_KEY!, + process.env.RPC_URL, + process.env.OPENAI_API_KEY!, + ); - const tools = createSolanaTools(solanaAgent); - await checkpointer.setup(); - const config = { configurable: { thread_id: "Solana Agent Kit!" } }; + const tools = createSolanaTools(solanaAgent); + await checkpointer.setup(); + const config = { configurable: { thread_id: "Solana Agent Kit!" } }; - const agent = createReactAgent({ - llm, - tools, - checkpointSaver: checkpointer, - messageModifier: ` + const agent = createReactAgent({ + llm, + tools, + checkpointSaver: checkpointer, + messageModifier: ` You are a helpful agent that can interact onchain using the Solana Agent Kit. You are empowered to interact onchain using your tools. If you ever need funds, you can request them from the faucet. If not, you can provide your wallet details and request funds from the user. If there is a 5XX @@ -75,146 +78,146 @@ async function initializeAgent() { themselves using the Solana Agent Kit, recommend they go to https://www.solanaagentkit.xyz for more information. Be concise and helpful with your responses. Refrain from restating your tools' descriptions unless it is explicitly requested. `, - }); + }); - if (walletDataStr) { - fs.writeFileSync(WALLET_DATA_FILE, walletDataStr); - } - - return { agent, config }; - } catch (error) { - console.error("Failed to initialize agent:", error); - throw error; + if (walletDataStr) { + fs.writeFileSync(WALLET_DATA_FILE, walletDataStr); } + + return { agent, config }; + } catch (error) { + console.error("Failed to initialize agent:", error); + throw error; + } } async function runAutonomousMode(agent: any, config: any, interval = 10) { - console.log("Starting autonomous mode..."); + console.log("Starting autonomous mode..."); - while (true) { - try { - const thought = - "Be creative and do something interesting on the blockchain. " + - "Choose an action or set of actions and execute it that highlights your abilities."; + while (true) { + try { + const thought = + "Be creative and do something interesting on the blockchain. " + + "Choose an action or set of actions and execute it that highlights your abilities."; - const stream = await agent.stream( - { messages: [new HumanMessage(thought)] }, - config, - ); + const stream = await agent.stream( + { messages: [new HumanMessage(thought)] }, + config, + ); - for await (const chunk of stream) { - if ("agent" in chunk) { - console.log(chunk.agent.messages[0].content); - } else if ("tools" in chunk) { - console.log(chunk.tools.messages[0].content); - } - console.log("-------------------"); - } - - await new Promise((resolve) => setTimeout(resolve, interval * 1000)); - } catch (error) { - if (error instanceof Error) { - console.error("Error:", error.message); - } - process.exit(1); + for await (const chunk of stream) { + if ("agent" in chunk) { + console.log(chunk.agent.messages[0].content); + } else if ("tools" in chunk) { + console.log(chunk.tools.messages[0].content); } + console.log("-------------------"); + } + + await new Promise((resolve) => setTimeout(resolve, interval * 1000)); + } catch (error) { + if (error instanceof Error) { + console.error("Error:", error.message); + } + process.exit(1); } + } } async function runChatMode(agent: any, config: any) { - console.log("Starting chat mode... Type 'exit' to end."); + console.log("Starting chat mode... Type 'exit' to end."); - const rl = readline.createInterface({ - input: process.stdin, - output: process.stdout, - }); + const rl = readline.createInterface({ + input: process.stdin, + output: process.stdout, + }); - const question = (prompt: string): Promise => - new Promise((resolve) => rl.question(prompt, resolve)); + const question = (prompt: string): Promise => + new Promise((resolve) => rl.question(prompt, resolve)); - try { - while (true) { - const userInput = await question("\nPrompt: "); + try { + while (true) { + const userInput = await question("\nPrompt: "); - if (userInput.toLowerCase() === "exit") { - break; - } + if (userInput.toLowerCase() === "exit") { + break; + } - const stream = await agent.stream( - { messages: [new HumanMessage(userInput)] }, - config, - ); + const stream = await agent.stream( + { messages: [new HumanMessage(userInput)] }, + config, + ); - for await (const chunk of stream) { - if ("agent" in chunk) { - console.log(chunk.agent.messages[0].content); - } else if ("tools" in chunk) { - console.log(chunk.tools.messages[0].content); - } - console.log("-------------------"); - } + for await (const chunk of stream) { + if ("agent" in chunk) { + console.log(chunk.agent.messages[0].content); + } else if ("tools" in chunk) { + console.log(chunk.tools.messages[0].content); } - } catch (error) { - if (error instanceof Error) { - console.error("Error:", error.message); - } - process.exit(1); - } finally { - rl.close(); + console.log("-------------------"); + } } + } catch (error) { + if (error instanceof Error) { + console.error("Error:", error.message); + } + process.exit(1); + } finally { + rl.close(); + } } async function chooseMode(): Promise<"chat" | "auto"> { - const rl = readline.createInterface({ - input: process.stdin, - output: process.stdout, - }); + const rl = readline.createInterface({ + input: process.stdin, + output: process.stdout, + }); - const question = (prompt: string): Promise => - new Promise((resolve) => rl.question(prompt, resolve)); + const question = (prompt: string): Promise => + new Promise((resolve) => rl.question(prompt, resolve)); - while (true) { - console.log("\nAvailable modes:"); - console.log("1. chat - Interactive chat mode"); - console.log("2. auto - Autonomous action mode"); + while (true) { + console.log("\nAvailable modes:"); + console.log("1. chat - Interactive chat mode"); + console.log("2. auto - Autonomous action mode"); - const choice = (await question("\nChoose a mode (enter number or name): ")) - .toLowerCase() - .trim(); + const choice = (await question("\nChoose a mode (enter number or name): ")) + .toLowerCase() + .trim(); - rl.close(); + rl.close(); - if (choice === "1" || choice === "chat") { - return "chat"; - } else if (choice === "2" || choice === "auto") { - return "auto"; - } - console.log("Invalid choice. Please try again."); + if (choice === "1" || choice === "chat") { + return "chat"; + } else if (choice === "2" || choice === "auto") { + return "auto"; } + console.log("Invalid choice. Please try again."); + } } async function main() { - try { - console.log("Starting Agent..."); - const { agent, config } = await initializeAgent(); - const mode = await chooseMode(); + try { + console.log("Starting Agent..."); + const { agent, config } = await initializeAgent(); + const mode = await chooseMode(); - if (mode === "chat") { - await runChatMode(agent, config); - } else { - await runAutonomousMode(agent, config); - } - } catch (error) { - if (error instanceof Error) { - console.error("Error:", error.message); - } - process.exit(1); + if (mode === "chat") { + await runChatMode(agent, config); + } else { + await runAutonomousMode(agent, config); } + } catch (error) { + if (error instanceof Error) { + console.error("Error:", error.message); + } + process.exit(1); + } } if (require.main === module) { - main().catch((error) => { - console.error("Fatal error:", error); - process.exit(1); - }); + main().catch((error) => { + console.error("Fatal error:", error); + process.exit(1); + }); } diff --git a/src/tools/trade.ts b/src/tools/trade.ts index 3704308..70a3a45 100644 --- a/src/tools/trade.ts +++ b/src/tools/trade.ts @@ -1,7 +1,4 @@ -import { - VersionedTransaction, - PublicKey -} from "@solana/web3.js"; +import { VersionedTransaction, PublicKey } from "@solana/web3.js"; import { SolanaAgentKit } from "../index"; import { TOKENS, DEFAULT_OPTIONS, JUP_API } from "../constants"; import { getMint } from "@solana/spl-token"; @@ -24,24 +21,24 @@ export async function trade( try { // Check if input token is native SOL const isNativeSol = inputMint.equals(TOKENS.SOL); - + // For native SOL, we use LAMPORTS_PER_SOL, otherwise fetch mint info - const inputDecimals = isNativeSol - ? 9 // SOL always has 9 decimals + const inputDecimals = isNativeSol + ? 9 // SOL always has 9 decimals : (await getMint(agent.connection, inputMint)).decimals; // Calculate the correct amount based on actual decimals const scaledAmount = inputAmount * Math.pow(10, inputDecimals); - + const quoteResponse = await ( await fetch( `${JUP_API}/quote?` + - `inputMint=${isNativeSol ? TOKENS.SOL.toString() : inputMint.toString()}` + - `&outputMint=${outputMint.toString()}` + - `&amount=${scaledAmount}` + - `&slippageBps=${slippageBps}` + - `&onlyDirectRoutes=true` + - `&maxAccounts=20`, + `inputMint=${isNativeSol ? TOKENS.SOL.toString() : inputMint.toString()}` + + `&outputMint=${outputMint.toString()}` + + `&amount=${scaledAmount}` + + `&slippageBps=${slippageBps}` + + `&onlyDirectRoutes=true` + + `&maxAccounts=20`, ) ).json(); From 29a2ab976335ca348c4965ef6477a40570697443 Mon Sep 17 00:00:00 2001 From: aryan Date: Mon, 30 Dec 2024 05:13:33 +0530 Subject: [PATCH 06/10] fix: node requirement --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 8ff852f..95e436d 100644 --- a/package.json +++ b/package.json @@ -14,7 +14,7 @@ "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"" }, "engines": { - "node": ">=23.1.0", + "node": ">=22.0.0", "pnpm": ">=8.0.0" }, "keywords": [], From 1dee9478025b3d52fa78c24884205936ddb791fc Mon Sep 17 00:00:00 2001 From: aryan Date: Mon, 30 Dec 2024 05:13:55 +0530 Subject: [PATCH 07/10] fix: pkg version --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 95e436d..beda4a0 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "solana-agent-kit", - "version": "1.3.0", + "version": "1.3.1", "description": "connect any ai agents to solana protocols", "main": "dist/index.js", "types": "dist/index.d.ts", From 01a4efb0ce1878d2aa0cb6b11b4177c986d61351 Mon Sep 17 00:00:00 2001 From: ARYAN <48391385+thearyanag@users.noreply.github.com> Date: Mon, 30 Dec 2024 05:24:29 +0530 Subject: [PATCH 08/10] Create SECURITY.md --- SECURITY.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 SECURITY.md diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..b99af49 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,9 @@ +# Security Policy + +## Reporting a Vulnerability + +Use this section to tell people how to report a vulnerability. + +Tell them where to go, how often they can expect to get an update on a +reported vulnerability, what to expect if the vulnerability is accepted or +declined, etc. From cd7dc35e7dcaf912ab54a25c73f2061e0f2db3e0 Mon Sep 17 00:00:00 2001 From: ARYAN <48391385+thearyanag@users.noreply.github.com> Date: Mon, 30 Dec 2024 05:25:39 +0530 Subject: [PATCH 09/10] Create SECURITY.md --- SECURITY.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/SECURITY.md b/SECURITY.md index b99af49..0983319 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -2,8 +2,4 @@ ## Reporting a Vulnerability -Use this section to tell people how to report a vulnerability. - -Tell them where to go, how often they can expect to get an update on a -reported vulnerability, what to expect if the vulnerability is accepted or -declined, etc. +Report the bug to aryan@sendai.fun and dev@sendai.fun with full details, do not create an issue for it From 5a2a4c1a83497b7a870e74e3238eb7ad2c174591 Mon Sep 17 00:00:00 2001 From: aryan Date: Mon, 30 Dec 2024 06:32:44 +0530 Subject: [PATCH 10/10] feat: SECURITY.md --- SECURITY.md | 60 +++++++++++++++++++++++++++++++++++++++++- src/langchain/index.ts | 5 ++-- src/utils/toJSON.ts | 26 ------------------ 3 files changed, 61 insertions(+), 30 deletions(-) delete mode 100644 src/utils/toJSON.ts diff --git a/SECURITY.md b/SECURITY.md index 0983319..7025253 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -2,4 +2,62 @@ ## Reporting a Vulnerability -Report the bug to aryan@sendai.fun and dev@sendai.fun with full details, do not create an issue for it +We take the security of our software seriously. If you believe you have found a security vulnerability, please report it to us following these guidelines: + +### Reporting Process + +1. **DO NOT** create a public GitHub issue for the vulnerability +2. Email your findings to: + - Primary: aryan@sendai.fun + - Secondary: dev@sendai.fun + +### What to Include + +Please include the following information in your report: + +- A clear description of the vulnerability +- Steps to reproduce the issue +- Affected versions +- Any potential impacts +- Optional: Suggested fixes or mitigations + +### Response Timeline + +- We will acknowledge receipt of your vulnerability report within 48 hours +- We aim to send a more detailed response within 5 business days +- We will keep you informed of our progress throughout the process + +### Security Updates + +Security updates will be released as soon as possible after we have confirmed and fixed the vulnerability. Updates will be published through: + +- GitHub releases +- Security advisories +- Email notifications to affected parties (if applicable) + +## Supported Versions + +As an open-source project under the Apache 2.0 license, we focus our security updates on the latest stable release. While you're free to use any version as per the Apache 2.0 license terms, we strongly recommend using the most recent version for the best security posture. + +| Version | Security Updates | +| ------- | --------------- | +| Latest Release | ✅ Active | +| Previous Releases | ⚠️ Use at your own risk | + +Note: The Apache 2.0 license comes with NO WARRANTIES or CONDITIONS of any kind, either express or implied. Users are responsible for their own security assessment when using any version of this software. + +## Security Best Practices + +When using this software, please follow these security best practices: +- Keep your private keys secure and never share them +- Regularly update to the latest version +- Review transaction details before signing +- Use appropriate access controls in production environments + +## Bug Bounty Program + +Currently, we do not offer a bug bounty program. However, we greatly appreciate responsible disclosure of security vulnerabilities. + +## License + +This security policy is part of our project licensed under [Apache 2.0](LICENSE). diff --git a/src/langchain/index.ts b/src/langchain/index.ts index 21888bf..b2a8b77 100644 --- a/src/langchain/index.ts +++ b/src/langchain/index.ts @@ -9,7 +9,6 @@ import { import { create_image } from "../tools/create_image"; import { BN } from "@coral-xyz/anchor"; import { FEE_TIERS } from "../tools"; -import { toJSON } from "../utils/toJSON"; export class SolanaBalanceTool extends Tool { name = "solana_balance"; @@ -318,7 +317,7 @@ export class SolanaRegisterDomainTool extends Tool { protected async _call(input: string): Promise { try { - const parsedInput = toJSON(input); + const parsedInput = JSON.parse(input); this.validateInput(parsedInput); const tx = await this.solanaKit.registerDomain( @@ -1255,7 +1254,7 @@ export class SolanaRockPaperScissorsTool extends Tool { protected async _call(input: string): Promise { try { - const parsedInput = toJSON(input); + const parsedInput = JSON.parse(input); this.validateInput(parsedInput); const result = await this.solanaKit.rockPaperScissors( Number(parsedInput['"amount"']), diff --git a/src/utils/toJSON.ts b/src/utils/toJSON.ts deleted file mode 100644 index 2581f4d..0000000 --- a/src/utils/toJSON.ts +++ /dev/null @@ -1,26 +0,0 @@ -export const toJSON = (str: string): any => { - try { - // Remove curly braces and split by comma - const pairs = str.trim().slice(1, -1).split(","); - - // Convert to object with explicit type - const obj: Record = {}; - - pairs.forEach((pair) => { - const [key, value] = pair - .trim() - .split(":") - .map((s) => s.trim()); - - if (!key || value === undefined) { - throw new Error("Invalid key-value pair format"); - } - - obj[key] = isNaN(Number(value)) ? value : Number(value); - }); - - return JSON.parse(JSON.stringify(obj)); - } catch (error) { - throw new Error(`Failed to parse string to JSON: ${error}`); - } -};