diff --git a/docs/assets/navigation.js b/docs/assets/navigation.js index bcaae4e..cce3849 100644 --- a/docs/assets/navigation.js +++ b/docs/assets/navigation.js @@ -1 +1 @@ -window.navigationData = "data:application/octet-stream;base64,H4sIAAAAAAAAE42TwU7DMAyG3yXniooJJtTbRNUDDJigN8QhCi6JltpR40hMaO+OtiFYWebtkos/f7asP69fiuGTVaVeyGvUsw9AvnesChU0W1Up43WMEMtx/cJy71Whlg7fVXU5uVkXv6Zb8h4MO8IagqdVD7jnc8gwdNpALHPgWDy5nmbFT2HzxhPWH0pUDqCZhrxoV5PaG2BjF4Mz8AwxEEbImg4xSXqXgmMYWloC1pp1VvkfkoTz5GlmDCXkGlg7H8Vtj+PSkAeH/Hf6x6YVZxylpRGL1Icu4VwnNFbUZ8lT6ibh9pxSuDKcqF2xPTMjeVSSm00+YfcvWyK/t3GXcHvYWB5AY+P0av32DUTvPWMEBAAA" \ No newline at end of file +window.navigationData = "data:application/octet-stream;base64,H4sIAAAAAAAAE43TQU+DMBQH8O/S8+LioovZjUgw6tRlEi/GQ1ffpKG0TfsaXYzf3cqMEykPLxzov78/PMrjO0N4Q7Zg90ZxzbMX0HgtkU2Y5VjF+0Jx78FPu+tHFTYqhmqpn9nieHb2MfmRzo1SIFAanYNVZtfELQdPagS35SKSqWAXnp3Ok/Cd/br6EfU7RZIOOBqXhvZr1PYCUFQrJwWswdvYBUmpH6PQC7l5Na5u66Hkvl7DMD0UpgqugpURKE0NOufIk/DfEAUugzKZECZozAG5VJ4cx3CcKrmJwuHb3hYl2TGYpipWobHboJc8aFGRfDI5RhdBt+OkTm8iR7I7rP55CNNRChftodr/+KUx6tcTx3dvB+unvVBXnJ/0wAdwAlR2OUJ2Yj306ROld4uPugQAAA==" \ No newline at end of file diff --git a/docs/assets/search.js b/docs/assets/search.js index b0786c5..26b312e 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 eccbc8c..1e9f3b9 100644 --- a/docs/classes/SolanaAgentKit.html +++ b/docs/classes/SolanaAgentKit.html @@ -1,12 +1,13 @@ 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 wallet_address -

Methods

createOrcaSingleSidedWhirlpool +

Methods

createGibworkTask +createOrcaSingleSidedWhirlpool deployCollection deployToken fetchTokenPrice @@ -36,7 +37,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

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>

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>

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>

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>

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 e52f87a..522c832 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)[]

  • 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)[]

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)[]

  • 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)[]

Settings

Member Visibility
diff --git a/docs/functions/createVercelAITools.html b/docs/functions/createVercelAITools.html new file mode 100644 index 0000000..1702ff1 --- /dev/null +++ b/docs/functions/createVercelAITools.html @@ -0,0 +1 @@ +createVercelAITools | solana-agent-kit

Function createVercelAITools

  • createVercelAITools(solanaKit): CoreTool[]

  • Parameters

    Returns CoreTool[]

Settings

Member Visibility
diff --git a/docs/index.html b/docs/index.html index 7dd0878..f76a141 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,6 +1,9 @@ solana-agent-kit

solana-agent-kit

-

Solana Agent Kit

-

Solana Agent Kit Cover 1 (3)

+

Solana Agent Kit

Solana Agent Kit Cover 1 (3)

+

NPM Downloads +GitHub forks +GitHub License

+

An open-source toolkit for connecting AI agents to Solana protocols. Now, any agent, using any model can autonomously perform 15+ Solana actions:

  • Solana Blinks

      -
    • Lending by Lulo
      • +
    • Lending by Lulon (Best APR for USDC)
    • Send Arcade Games
    • JupSOL staking
    • +
  • +

    Non-Financial Actions

    +
      +
    • Gib Work for registering bounties
      • +
    +

    • 🤖 AI Integration Features

    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.

    -

    License

    MIT License

    +

    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
    diff --git a/docs/interfaces/CollectionDeployment.html b/docs/interfaces/CollectionDeployment.html index c03b39a..078c9aa 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 6790105..a30acbc 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 4e33592..c0db0d3 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 defd401..9034730 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 new file mode 100644 index 0000000..5756fef --- /dev/null +++ b/docs/interfaces/GibworkCreateTaskReponse.html @@ -0,0 +1,4 @@ +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
    diff --git a/docs/interfaces/JupiterTokenData.html b/docs/interfaces/JupiterTokenData.html index 2b23375..e7e78b6 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 fa19d62..dd11aee 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 e2e1479..1289741 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 d1c0142..cb37c94 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 f667de7..c98ea41 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 fcfb217..a83df74 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/docs/modules.html b/docs/modules.html index 29440e3..791b567 100644 --- a/docs/modules.html +++ b/docs/modules.html @@ -3,6 +3,7 @@ CollectionOptions Creator FetchPriceResponse +GibworkCreateTaskReponse JupiterTokenData LuloAccountDetailsResponse MintCollectionNFTResponse @@ -10,4 +11,5 @@ PumpFunTokenOptions PythFetchPriceResponse

    Functions

    createSolanaTools +createVercelAITools

    Settings

    Member Visibility
    diff --git a/package.json b/package.json index abd3301..8ba7b4a 100644 --- a/package.json +++ b/package.json @@ -1,68 +1,72 @@ { - "name": "solana-agent-kit", - "version": "1.3.0", - "description": "connect any ai agents to solana protocols", - "main": "dist/index.js", - "types": "dist/index.d.ts", - "scripts": { - "build": "tsc", - "docs": "typedoc src --out docs", - "test": "ts-node test/index.ts", - "generate": "ts-node src/utils/keypair.ts", - "lint": "eslint . --ext .ts", - "lint:fix": "eslint . --ext .ts --fix", - "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"" - }, - "engines": { - "node": ">=23.1.0", - "pnpm": ">=8.0.0" - }, - "keywords": [], - "author": "sendaifun", - "license": "Apache-2.0", - "dependencies": { - "@bonfida/spl-name-service": "^3.0.7", - "@coral-xyz/anchor": "0.29", - "@langchain/core": "^0.3.18", - "@langchain/groq": "^0.1.2", - "@langchain/langgraph": "^0.2.27", - "@langchain/openai": "^0.3.13", - "@lightprotocol/compressed-token": "^0.17.1", - "@lightprotocol/stateless.js": "^0.17.1", - "@metaplex-foundation/mpl-core": "^1.1.1", - "@metaplex-foundation/mpl-token-metadata": "^3.3.0", - "@metaplex-foundation/mpl-toolbox": "^0.9.4", - "@metaplex-foundation/umi": "^0.9.2", - "@metaplex-foundation/umi-bundle-defaults": "^0.9.2", - "@metaplex-foundation/umi-web3js-adapters": "^0.9.2", - "@onsol/tldparser": "^0.6.7", - "@orca-so/common-sdk": "0.6.4", - "@orca-so/whirlpools-sdk": "^0.13.12", - "@pythnetwork/price-service-client": "^1.9.0", - "@raydium-io/raydium-sdk-v2": "0.1.95-alpha", - "@solana/spl-token": "^0.4.9", - "@solana/web3.js": "^1.95.4", - "bn.js": "^5.2.1", - "bs58": "^6.0.0", - "chai": "^5.1.2", - "decimal.js": "^10.4.3", - "dotenv": "^16.4.5", - "form-data": "^4.0.1", - "langchain": "^0.3.6", - "openai": "^4.75.0", - "typedoc": "^0.26.11" - }, - "devDependencies": { - "@types/bn.js": "^5.1.5", - "@types/chai": "^5.0.1", - "@types/node": "^22.9.0", - "ts-node": "^10.9.2", - "typescript": "^5.7.2", - "eslint": "^8.56.0", - "eslint-config-prettier": "^9.1.0", - "eslint-plugin-prettier": "^5.1.3", - "@typescript-eslint/eslint-plugin": "^7.0.0", - "@typescript-eslint/parser": "^7.0.0", - "prettier": "^3.2.5" - } + "name": "solana-agent-kit", + "version": "1.3.0", + "description": "connect any ai agents to solana protocols", + "main": "dist/index.js", + "types": "dist/index.d.ts", + "scripts": { + "build": "tsc", + "docs": "typedoc src --out docs", + "test": "ts-node test/index.ts", + "test:vercel-ai": "ts-node test/agent_sdks/vercel_ai.ts", + "generate": "ts-node src/utils/keypair.ts", + "lint": "eslint . --ext .ts", + "lint:fix": "eslint . --ext .ts --fix", + "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"" + }, + "engines": { + "node": ">=23.1.0", + "pnpm": ">=8.0.0" + }, + "keywords": [], + "author": "sendaifun", + "license": "Apache-2.0", + "dependencies": { + "@ai-sdk/openai": "^1.0.11", + "@bonfida/spl-name-service": "^3.0.7", + "@coral-xyz/anchor": "0.29", + "@langchain/core": "^0.3.18", + "@langchain/groq": "^0.1.2", + "@langchain/langgraph": "^0.2.27", + "@langchain/openai": "^0.3.13", + "@lightprotocol/compressed-token": "^0.17.1", + "@lightprotocol/stateless.js": "^0.17.1", + "@metaplex-foundation/mpl-core": "^1.1.1", + "@metaplex-foundation/mpl-token-metadata": "^3.3.0", + "@metaplex-foundation/mpl-toolbox": "^0.9.4", + "@metaplex-foundation/umi": "^0.9.2", + "@metaplex-foundation/umi-bundle-defaults": "^0.9.2", + "@metaplex-foundation/umi-web3js-adapters": "^0.9.2", + "@onsol/tldparser": "^0.6.7", + "@orca-so/common-sdk": "0.6.4", + "@orca-so/whirlpools-sdk": "^0.13.12", + "@pythnetwork/price-service-client": "^1.9.0", + "@raydium-io/raydium-sdk-v2": "0.1.95-alpha", + "@solana/spl-token": "^0.4.9", + "@solana/web3.js": "^1.95.4", + "ai": "^4.0.22", + "bn.js": "^5.2.1", + "bs58": "^6.0.0", + "chai": "^5.1.2", + "decimal.js": "^10.4.3", + "dotenv": "^16.4.5", + "form-data": "^4.0.1", + "langchain": "^0.3.6", + "openai": "^4.75.0", + "typedoc": "^0.26.11", + "zod": "^3.24.1" + }, + "devDependencies": { + "@types/bn.js": "^5.1.5", + "@types/chai": "^5.0.1", + "@types/node": "^22.9.0", + "@typescript-eslint/eslint-plugin": "^7.0.0", + "@typescript-eslint/parser": "^7.0.0", + "eslint": "^8.56.0", + "eslint-config-prettier": "^9.1.0", + "eslint-plugin-prettier": "^5.1.3", + "prettier": "^3.2.5", + "ts-node": "^10.9.2", + "typescript": "^5.7.2" + } } diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index ddfc583..d5b467a 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -8,6 +8,9 @@ importers: .: dependencies: + '@ai-sdk/openai': + specifier: ^1.0.11 + version: 1.0.11(zod@3.24.1) '@bonfida/spl-name-service': specifier: ^3.0.7 version: 3.0.7(@solana/web3.js@1.98.0(bufferutil@4.0.8)(utf-8-validate@5.0.10))(bufferutil@4.0.8)(fastestsmallesttextencoderdecoder@1.0.22)(typescript@5.7.2)(utf-8-validate@5.0.10) @@ -71,6 +74,9 @@ importers: '@solana/web3.js': specifier: ^1.95.4 version: 1.98.0(bufferutil@4.0.8)(utf-8-validate@5.0.10) + ai: + specifier: ^4.0.22 + version: 4.0.22(react@19.0.0)(zod@3.24.1) bn.js: specifier: ^5.2.1 version: 5.2.1 @@ -98,6 +104,9 @@ importers: typedoc: specifier: ^0.26.11 version: 0.26.11(typescript@5.7.2) + zod: + specifier: ^3.24.1 + version: 3.24.1 devDependencies: '@types/bn.js': specifier: ^5.1.5 @@ -135,6 +144,46 @@ importers: packages: + '@ai-sdk/openai@1.0.11': + resolution: {integrity: sha512-qI9s7Slma5i5bB4yYVlFdcG3PNDwdqivPT1Dr8adDX92nSSpILjgFIooS5yys9sXjvvcfOi/WXbDvVhLSRRlvg==} + engines: {node: '>=18'} + peerDependencies: + zod: ^3.0.0 + + '@ai-sdk/provider-utils@2.0.5': + resolution: {integrity: sha512-2M7vLhYN0ThGjNlzow7oO/lsL+DyMxvGMIYmVQvEYaCWhDzxH5dOp78VNjJIVwHzVLMbBDigX3rJuzAs853idw==} + engines: {node: '>=18'} + peerDependencies: + zod: ^3.0.0 + peerDependenciesMeta: + zod: + optional: true + + '@ai-sdk/provider@1.0.3': + resolution: {integrity: sha512-WiuJEpHTrltOIzv3x2wx4gwksAHW0h6nK3SoDzjqCOJLu/2OJ1yASESTIX+f07ChFykHElVoP80Ol/fe9dw6tQ==} + engines: {node: '>=18'} + + '@ai-sdk/react@1.0.7': + resolution: {integrity: sha512-j2/of4iCNq+r2Bjx0O9vdRhn5C/02t2Esenis71YtnsoynPz74eQlJ3N0RYYPheThiJes50yHdfdVdH9ulxs1A==} + engines: {node: '>=18'} + peerDependencies: + react: ^18 || ^19 || ^19.0.0-rc + zod: ^3.0.0 + peerDependenciesMeta: + react: + optional: true + zod: + optional: true + + '@ai-sdk/ui-utils@1.0.6': + resolution: {integrity: sha512-ZP6Vjj+VCnSPBIAvWAdKj2olQONJ/f4aZpkVCGkzprdhv8TjHwB6CTlXFS3zypuEGy4asg84dc1dvXKooQXFvg==} + engines: {node: '>=18'} + peerDependencies: + zod: ^3.0.0 + peerDependenciesMeta: + zod: + optional: true + '@babel/runtime@7.26.0': resolution: {integrity: sha512-FDSOghenHTiToteC/QRlv2q3DhPZ/oOXTBoirfWNx1Cx3TMVcGWQtMMmQcSvb/JjpNeGzx8Pq/b4fKEJuWm1sw==} engines: {node: '>=6.9.0'} @@ -400,6 +449,10 @@ packages: borsh: ^0.7.0 buffer: 6.0.1 + '@opentelemetry/api@1.9.0': + resolution: {integrity: sha512-3giAOQvZiH5F9bMlMiv8+GSPMeqg0dbaeo58/0SlA9sxSqZhnUtxzX9/2FzyhS9sWQf5S0GJE0AKBrFqjpeYcg==} + engines: {node: '>=8.0.0'} + '@orca-so/common-sdk@0.6.4': resolution: {integrity: sha512-iOiC6exTA9t2CEOaUPoWlNP3soN/1yZFjoz1mSf7NvOqo/PJZeIdWpB7BRXwU0mGGatjxU4SFgMGQ8NrSx+ONw==} peerDependencies: @@ -633,6 +686,9 @@ packages: '@types/deep-eql@4.0.2': resolution: {integrity: sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==} + '@types/diff-match-patch@1.0.36': + resolution: {integrity: sha512-xFdR6tkm0MWvBfO8xXCSsinYxHcqkQUlcHeSpMC2ukzOb6lwQAfDmW+Qt0AvlGd8HpsS28qKsB+oPeJn9I39jg==} + '@types/hast@3.0.4': resolution: {integrity: sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==} @@ -759,6 +815,18 @@ packages: resolution: {integrity: sha512-5GG/5IbQQpC9FpkRGsSvZI5QYeSCzlJHdpBQntCsuTOxhKD8lqKhrleg2Yi7yvMIf82Ycmmqln9U8V9qwEiJew==} engines: {node: '>= 8.0.0'} + ai@4.0.22: + resolution: {integrity: sha512-yvcjWtofI2HZwgT3jMkoNnDUhAY+S9cOvZ6xbbOzrS0ZeFl1/gcbasFnwAqUJ7uL/t72/3a0Vy/pKg6N19A2Mw==} + engines: {node: '>=18'} + peerDependencies: + react: ^18 || ^19 || ^19.0.0-rc + zod: ^3.0.0 + peerDependenciesMeta: + react: + optional: true + zod: + optional: true + ajv@6.12.6: resolution: {integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==} @@ -1016,6 +1084,9 @@ packages: devlop@1.1.0: resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==} + diff-match-patch@1.0.5: + resolution: {integrity: sha512-IayShXAgj/QMXgB0IWmKx+rOPuGMhqm5w6jvFxmVenXKIzRqTAAsbBPT3kWQeGANj3jGgvcvv4yK6SxqYmikgw==} + diff@4.0.2: resolution: {integrity: sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==} engines: {node: '>=0.3.1'} @@ -1132,6 +1203,10 @@ packages: eventemitter3@5.0.1: resolution: {integrity: sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==} + eventsource-parser@3.0.0: + resolution: {integrity: sha512-T1C0XCUimhxVQzW4zFipdx0SficT651NnkR0ZSH3yQwh+mFMdLfgjABVi4YtMTtaL4s168593DaoaRLMqryavA==} + engines: {node: '>=18.0.0'} + eyes@0.1.8: resolution: {integrity: sha512-GipyPsXO1anza0AOZdy69Im7hGFCNB7Y/NGjDlZGJ3GJJLtwNSb2vrzYrTYJRrRloVx7pl+bhUaTB8yiccPvFQ==} engines: {node: '> 0.1.90'} @@ -1381,6 +1456,9 @@ packages: json-schema-traverse@0.4.1: resolution: {integrity: sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==} + json-schema@0.4.0: + resolution: {integrity: sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==} + json-stable-stringify-without-jsonify@1.0.1: resolution: {integrity: sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==} @@ -1392,6 +1470,11 @@ packages: engines: {node: '>=6'} hasBin: true + jsondiffpatch@0.6.0: + resolution: {integrity: sha512-3QItJOXp2AP1uv7waBkao5nCvhEv+QmJAd38Ybq7wNI74Q+BBmnLn4EDKz6yI9xGAIQoUF87qHt+kc1IVxB4zQ==} + engines: {node: ^18.0.0 || >=20.0.0} + hasBin: true + jsonfile@6.1.0: resolution: {integrity: sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==} @@ -1554,6 +1637,11 @@ packages: resolution: {integrity: sha512-71ippSywq5Yb7/tVYyGbkBggbU8H3u5Rz56fH60jGFgr8uHwxs+aSKeqmluIVzM0m0kB7xQjKS6qPfd0b2ZoqQ==} hasBin: true + nanoid@3.3.8: + resolution: {integrity: sha512-WNLf5Sd8oZxOm+TzppcYk8gVOgP+l58xNy58D0nbUnOxOWRWvlcCV4kUF7ltmI6PsrLl/BgKEyS4mqsGChFN0w==} + engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1} + hasBin: true + natural-compare@1.4.0: resolution: {integrity: sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==} @@ -1703,6 +1791,10 @@ packages: queue-microtask@1.2.3: resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==} + react@19.0.0: + resolution: {integrity: sha512-V8AVnmPIICiWpGfm6GLzCR/W5FXLchHop40W4nXBmdlEceh16rCN8O8LNWm5bh5XUX91fh7KpA+W0TgMKmgTpQ==} + engines: {node: '>=0.10.0'} + regenerator-runtime@0.14.1: resolution: {integrity: sha512-dYnhHh0nJoMfnkZs6GmmhFknAGRrLznOu5nc9ML+EJxGvrx6H7teuevqVqCuPcPK//3eDrrjQhehXVx9cnkGdw==} @@ -1741,6 +1833,9 @@ packages: safe-buffer@5.2.1: resolution: {integrity: sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==} + secure-json-parse@2.7.0: + resolution: {integrity: sha512-6aU+Rwsezw7VR8/nyvKTx8QpWH9FrcYiXXlqC4z5d5XQBDRqtbfsRjnwGyqbi3gddNtWHuEk9OANUotL26qKUw==} + semver@7.6.3: resolution: {integrity: sha512-oVekP1cKtI+CTDvHWYFUcMtsK/00wmAEfyqKfNdARm8u1wNVhSgaX7A8d4UuIlUI5e84iEwOhs7ZPYRmzU9U6A==} engines: {node: '>=10'} @@ -1797,6 +1892,11 @@ packages: resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==} engines: {node: '>=8'} + swr@2.3.0: + resolution: {integrity: sha512-NyZ76wA4yElZWBHzSgEJc28a0u6QZvhb6w0azeL2k7+Q1gAzVK+IqQYXhVOC/mzi+HZIozrZvBVeSeOZNR2bqA==} + peerDependencies: + react: ^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 + synckit@0.9.2: resolution: {integrity: sha512-vrozgXDQwYO72vHjUb/HnFbQx1exDjoKzqx23aXEg2a9VIg2TSFZ8FmeZpTjUCFMYw7mpX4BE2SFu8wI7asYsw==} engines: {node: ^14.18.0 || >=16.0.0} @@ -1807,6 +1907,10 @@ packages: text-table@0.2.0: resolution: {integrity: sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==} + throttleit@2.1.0: + resolution: {integrity: sha512-nt6AMGKW1p/70DF/hGBdJB57B8Tspmbp5gfJ8ilhLnt7kkr2ye7hzD6NVG8GGErk2HWF34igrL2CXmNIkzKqKw==} + engines: {node: '>=18'} + through@2.3.8: resolution: {integrity: sha512-w89qg7PI8wAdvX60bMDP+bFoD5Dvhm9oLheFp5O4a2QF0cSBGsBX4qZmadPMvVqlLJBBci+WqGGOAPvcDeNSVg==} @@ -1919,6 +2023,11 @@ packages: uri-js@4.4.1: resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==} + use-sync-external-store@1.4.0: + resolution: {integrity: sha512-9WXSPC5fMv61vaupRkCKCxsPxBocVnwakBEkMIHHpkTTg6icbJtg6jzgtLDm4bl3cSHAca52rYWih0k4K3PfHw==} + peerDependencies: + react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 + utf-8-validate@5.0.10: resolution: {integrity: sha512-Z6czzLq4u8fPOyx7TU6X3dvUZVvoJmxSQ+IcrlmagKhilxlhZgxPK6C5Jqbkw1IDUmFTM+cz9QDnnLTwDz/2gQ==} engines: {node: '>=6.14.2'} @@ -2027,6 +2136,43 @@ packages: snapshots: + '@ai-sdk/openai@1.0.11(zod@3.24.1)': + dependencies: + '@ai-sdk/provider': 1.0.3 + '@ai-sdk/provider-utils': 2.0.5(zod@3.24.1) + zod: 3.24.1 + + '@ai-sdk/provider-utils@2.0.5(zod@3.24.1)': + dependencies: + '@ai-sdk/provider': 1.0.3 + eventsource-parser: 3.0.0 + nanoid: 3.3.8 + secure-json-parse: 2.7.0 + optionalDependencies: + zod: 3.24.1 + + '@ai-sdk/provider@1.0.3': + dependencies: + json-schema: 0.4.0 + + '@ai-sdk/react@1.0.7(react@19.0.0)(zod@3.24.1)': + dependencies: + '@ai-sdk/provider-utils': 2.0.5(zod@3.24.1) + '@ai-sdk/ui-utils': 1.0.6(zod@3.24.1) + swr: 2.3.0(react@19.0.0) + throttleit: 2.1.0 + optionalDependencies: + react: 19.0.0 + zod: 3.24.1 + + '@ai-sdk/ui-utils@1.0.6(zod@3.24.1)': + dependencies: + '@ai-sdk/provider': 1.0.3 + '@ai-sdk/provider-utils': 2.0.5(zod@3.24.1) + zod-to-json-schema: 3.24.1(zod@3.24.1) + optionalDependencies: + zod: 3.24.1 + '@babel/runtime@7.26.0': dependencies: regenerator-runtime: 0.14.1 @@ -2403,6 +2549,8 @@ snapshots: - supports-color - utf-8-validate + '@opentelemetry/api@1.9.0': {} + '@orca-so/common-sdk@0.6.4(@solana/spl-token@0.4.9(@solana/web3.js@1.98.0(bufferutil@4.0.8)(utf-8-validate@5.0.10))(bufferutil@4.0.8)(fastestsmallesttextencoderdecoder@1.0.22)(typescript@5.7.2)(utf-8-validate@5.0.10))(@solana/web3.js@1.98.0(bufferutil@4.0.8)(utf-8-validate@5.0.10))(decimal.js@10.4.3)': dependencies: '@solana/spl-token': 0.4.9(@solana/web3.js@1.98.0(bufferutil@4.0.8)(utf-8-validate@5.0.10))(bufferutil@4.0.8)(fastestsmallesttextencoderdecoder@1.0.22)(typescript@5.7.2)(utf-8-validate@5.0.10) @@ -2815,6 +2963,8 @@ snapshots: '@types/deep-eql@4.0.2': {} + '@types/diff-match-patch@1.0.36': {} + '@types/hast@3.0.4': dependencies: '@types/unist': 3.0.3 @@ -2962,6 +3112,19 @@ snapshots: dependencies: humanize-ms: 1.2.1 + ai@4.0.22(react@19.0.0)(zod@3.24.1): + dependencies: + '@ai-sdk/provider': 1.0.3 + '@ai-sdk/provider-utils': 2.0.5(zod@3.24.1) + '@ai-sdk/react': 1.0.7(react@19.0.0)(zod@3.24.1) + '@ai-sdk/ui-utils': 1.0.6(zod@3.24.1) + '@opentelemetry/api': 1.9.0 + jsondiffpatch: 0.6.0 + zod-to-json-schema: 3.24.1(zod@3.24.1) + optionalDependencies: + react: 19.0.0 + zod: 3.24.1 + ajv@6.12.6: dependencies: fast-deep-equal: 3.1.3 @@ -3205,6 +3368,8 @@ snapshots: dependencies: dequal: 2.0.3 + diff-match-patch@1.0.5: {} + diff@4.0.2: {} dir-glob@3.0.1: @@ -3335,6 +3500,8 @@ snapshots: eventemitter3@5.0.1: {} + eventsource-parser@3.0.0: {} + eyes@0.1.8: {} fast-deep-equal@3.1.3: {} @@ -3614,12 +3781,20 @@ snapshots: json-schema-traverse@0.4.1: {} + json-schema@0.4.0: {} + json-stable-stringify-without-jsonify@1.0.1: {} json-stringify-safe@5.0.1: {} json5@2.2.3: {} + jsondiffpatch@0.6.0: + dependencies: + '@types/diff-match-patch': 1.0.36 + chalk: 5.4.0 + diff-match-patch: 1.0.5 + jsonfile@6.1.0: dependencies: universalify: 2.0.1 @@ -3765,6 +3940,8 @@ snapshots: mustache@4.2.0: {} + nanoid@3.3.8: {} + natural-compare@1.4.0: {} no-case@3.0.4: @@ -3896,6 +4073,8 @@ snapshots: queue-microtask@1.2.3: {} + react@19.0.0: {} + regenerator-runtime@0.14.1: {} regex-recursion@5.0.0: @@ -3937,6 +4116,8 @@ snapshots: safe-buffer@5.2.1: {} + secure-json-parse@2.7.0: {} + semver@7.6.3: {} set-function-length@1.2.2: @@ -3993,6 +4174,12 @@ snapshots: dependencies: has-flag: 4.0.0 + swr@2.3.0(react@19.0.0): + dependencies: + dequal: 2.0.3 + react: 19.0.0 + use-sync-external-store: 1.4.0(react@19.0.0) + synckit@0.9.2: dependencies: '@pkgr/core': 0.1.1 @@ -4002,6 +4189,8 @@ snapshots: text-table@0.2.0: {} + throttleit@2.1.0: {} + through@2.3.8: {} tiny-inflate@1.0.3: {} @@ -4111,6 +4300,10 @@ snapshots: dependencies: punycode: 2.3.1 + use-sync-external-store@1.4.0(react@19.0.0): + dependencies: + react: 19.0.0 + utf-8-validate@5.0.10: dependencies: node-gyp-build: 4.8.4 diff --git a/src/index.ts b/src/index.ts index 1b4116f..4a9f3a4 100644 --- a/src/index.ts +++ b/src/index.ts @@ -1,7 +1,8 @@ import { SolanaAgentKit } from "./agent"; import { createSolanaTools } from "./langchain"; +import { createSolanaTools as createVercelAITools } from "./vercel-ai"; -export { SolanaAgentKit, createSolanaTools }; +export { SolanaAgentKit, createSolanaTools, createVercelAITools }; // Optional: Export types that users might need export * from "./types"; diff --git a/src/vercel-ai/index.ts b/src/vercel-ai/index.ts new file mode 100644 index 0000000..31c9f25 --- /dev/null +++ b/src/vercel-ai/index.ts @@ -0,0 +1,1489 @@ +import { tool, type CoreTool } from "ai"; +import { SolanaAgentKit } from "../agent"; +import z from "zod"; +import { PublicKey } from "@solana/web3.js"; +import { create_image } from "../tools/create_image"; +import BN from "bn.js"; +import Decimal from "decimal.js"; +import { FEE_TIERS } from "../tools"; +import { GibworkCreateTaskReponse, PythFetchPriceResponse } from "../types"; + +export class VercelAITools { + constructor(private solanaKit: SolanaAgentKit) {} + + solanaBalanceTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.balance", + description: `Get the balance of a Solana wallet or token account. + + If you want to get the balance of your wallet, you don't need to provide the tokenAddress. + If no tokenAddress is provided, the balance will be in SOL. + + Inputs: + tokenAccountAddress: string, eg "So11111111111111111111111111111111111111112" (optional)`, + parameters: z.object({ + tokenAccountAddress: z.string().optional(), + }), + execute: async ({ tokenAccountAddress }) => { + try { + const address = tokenAccountAddress + ? new PublicKey(tokenAccountAddress) + : undefined; + const balance = await this.solanaKit.getBalance(address); + + return { + status: "success", + balance: balance, + token: address ? address.toBase58() : "SOL", + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaTransferTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.transfer", + description: ` + Transfer tokens or SOL to another address ( also called as wallet address ). + + Inputs ( input is a JSON string ): + to: string, eg "8x2dR8Mpzuz2YqyZyZjUbYWKSWesBo5jMx2Q9Y86udVk" (required) + amount: number, eg 1 (required) + mint?: string, eg "So11111111111111111111111111111111111111112" or "SENDdRQtYMWaQrBroBrJ2Q53fgVuq95CV9UPGEvpCxa" (optional) `, + parameters: z.object({ + to: z.string(), + amount: z.number(), + mint: z.string().optional(), + }), + execute: async ({ to, amount, mint }) => { + try { + const recipient = new PublicKey(to); + const mintAddress = mint ? new PublicKey(mint) : undefined; + + const tx = await this.solanaKit.transfer( + recipient, + amount, + mintAddress, + ); + + return { + status: "success", + message: "Transfer completed successfully", + amount: amount, + recipient: to, + token: mint || "SOL", + transaction: tx, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaDeployTokenTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.deployToken", + description: `Deploy a new token on Solana blockchain. + + Inputs (input is a JSON string): + name: string, eg "My Token" (required) + uri: string, eg "https://example.com/token.json" (required) + symbol: string, eg "MTK" (required) + decimals?: number, eg 9 (optional, defaults to 9) + initialSupply?: number, eg 1000000 (optional)`, + parameters: z.object({ + name: z.string(), + uri: z.string(), + symbol: z.string(), + decimals: z.number().optional(), + initialSupply: z.number().optional(), + }), + execute: async ({ + name, + uri, + symbol, + decimals = 9, + initialSupply = 0, + }) => { + try { + const result = await this.solanaKit.deployToken( + name, + uri, + symbol, + decimals, + initialSupply, + ); + + return { + status: "success", + message: "Token deployed successfully", + mintAddress: result.mint.toString(), + decimals: decimals || 9, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaDeployCollectionTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.deployCollection", + description: "Deploy a new NFT collection on Solana blockchain", + parameters: z.object({ + name: z.string(), + uri: z.string(), + royaltyBasisPoints: z.number().optional(), + }), + execute: async ({ name, uri, royaltyBasisPoints = 0 }) => { + try { + const result = await this.solanaKit.deployCollection({ + name, + uri, + royaltyBasisPoints, + }); + return { + status: "success", + message: "Collection deployed successfully", + collectionAddress: result.collectionAddress.toString(), + name, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaMintNFTTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.mintNFT", + description: "Mint a new NFT in a collection on Solana blockchain", + parameters: z.object({ + collectionMint: z.string(), + name: z.string(), + uri: z.string(), + recipient: z.string().optional(), + }), + execute: async ({ collectionMint, name, uri, recipient }) => { + try { + const result = await this.solanaKit.mintNFT( + new PublicKey(collectionMint), + { name, uri }, + recipient + ? new PublicKey(recipient) + : this.solanaKit.wallet_address, + ); + return { + status: "success", + message: "NFT minted successfully", + mintAddress: result.mint.toString(), + metadata: { name, uri }, + recipient: recipient || result.mint.toString(), + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaTradeTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.trade", + description: "Swap tokens using Jupiter Exchange", + parameters: z.object({ + outputMint: z.string(), + inputAmount: z.number(), + inputMint: z.string().optional(), + slippageBps: z.number().optional(), + }), + execute: async ({ outputMint, inputAmount, inputMint, slippageBps }) => { + try { + const tx = await this.solanaKit.trade( + new PublicKey(outputMint), + inputAmount, + inputMint + ? new PublicKey(inputMint) + : new PublicKey("So11111111111111111111111111111111111111112"), + slippageBps, + ); + return { + status: "success", + message: "Trade executed successfully", + transaction: tx, + inputAmount, + inputToken: inputMint || "SOL", + outputToken: outputMint, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaRequestFundsTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.requestFunds", + description: "Request SOL from Solana faucet (devnet/testnet only)", + parameters: z.object({}), + execute: async () => { + try { + await this.solanaKit.requestFaucetFunds(); + return { + status: "success", + message: "Successfully requested faucet funds", + network: this.solanaKit.connection.rpcEndpoint.split("/")[2], + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaRegisterDomainTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.registerDomain", + description: "Register a .sol domain name for your wallet", + parameters: z.object({ + name: z.string().min(1, "Name is required"), + spaceKB: z + .number() + .positive("spaceKB must be a positive number") + .default(1) + .optional(), + }), + execute: async ({ name, spaceKB = 1 }) => { + try { + const tx = await this.solanaKit.registerDomain(name, spaceKB); + return { + status: "success", + message: "Domain registered successfully", + transaction: tx, + domain: `${name}.sol`, + spaceKB, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaResolveDomainTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.resolveDomain", + description: `Resolve ONLY .sol domain names to a Solana PublicKey. + This tool is exclusively for .sol domains. + DO NOT use this for other domain types like .blink, .bonk, etc.`, + parameters: z.object({ + domain: z + .string() + .trim() + .min(1, "Domain name is required") + .regex(/\.sol$/, "Domain must end with .sol"), + }), + execute: async ({ domain }) => { + try { + const publicKey = await this.solanaKit.resolveSolDomain(domain); + return { + status: "success", + message: "Domain resolved successfully", + publicKey: publicKey.toBase58(), + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaGetDomainTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.getDomain", + description: + "Retrieve the .sol domain associated with a given account address", + parameters: z.object({ + account: z + .string() + .trim() + .min(1, "Account address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid Solana account address"), + }), + execute: async ({ account }) => { + try { + const publicKey = new PublicKey(account); + const domain = await this.solanaKit.getPrimaryDomain(publicKey); + return { + status: "success", + message: "Primary domain retrieved successfully", + domain, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaGetWalletAddressTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.getWalletAddress", + description: "Get the wallet address of the agent", + parameters: z.object({}), + execute: async () => { + return { + status: "success", + message: "Wallet address retrieved successfully", + address: this.solanaKit.wallet_address.toString(), + }; + }, + }); + } + + solanaPumpfunTokenLaunchTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.launchPumpfunToken", + description: `Launch a token on Pump.fun. + Do not use this tool for any other purpose, or for creating SPL tokens. + If the user asks you to choose the parameters, you should generate valid values. + For generating the image, you can use the solana_create_image tool.`, + parameters: z.object({ + tokenName: z.string().min(1, "Token name is required"), + tokenTicker: z.string().min(1, "Token ticker is required"), + description: z.string().min(1, "Description is required"), + imageUrl: z.string().url("Invalid image URL"), + twitter: z.string().url("Invalid Twitter URL").optional(), + telegram: z.string().url("Invalid Telegram URL").optional(), + website: z.string().url("Invalid website URL").optional(), + initialLiquiditySOL: z + .number() + .positive("Initial liquidity must be positive") + .optional(), + }), + execute: async ({ + tokenName, + tokenTicker, + description, + imageUrl, + twitter, + telegram, + website, + initialLiquiditySOL, + }) => { + try { + await this.solanaKit.launchPumpFunToken( + tokenName, + tokenTicker, + description, + imageUrl, + // @ts-expect-error Value matches type however TS still shows error + { + twitter, + telegram, + website, + initialLiquiditySOL, + }, + ); + + return { + status: "success", + message: "Token launched successfully on Pump.fun", + tokenName, + tokenTicker, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaCreateImageTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.createImage", + description: + "Create an image using OpenAI's DALL-E. Input should be a string prompt for the image.", + parameters: z.object({ + prompt: z.string().trim().min(1, "Image prompt cannot be empty"), + }), + execute: async ({ prompt }) => { + try { + const result = await create_image(this.solanaKit, prompt); + return { + status: "success", + message: "Image created successfully", + ...result, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaLendAssetTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.lendAsset", + description: + "Lend idle USDC for yield using Lulo (only USDC is supported)", + parameters: z.object({ + amount: z + .number() + .positive("Amount must be positive") + .min(0.000001, "Amount must be at least 0.000001 USDC"), + }), + execute: async ({ amount }) => { + try { + const tx = await this.solanaKit.lendAssets(amount); + return { + status: "success", + message: "Asset lent successfully", + transaction: tx, + amount, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaTPSCalculatorTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.getTPS", + description: + "Get the current TPS (transactions per second) of the Solana network", + parameters: z.object({}), + execute: async () => { + try { + const tps = await this.solanaKit.getTPS(); + return { + status: "success", + message: "TPS fetched successfully", + network: "mainnet-beta", + tps: tps, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaStakeTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.stake", + description: + "Stake your SOL (Solana), also called as SOL staking or liquid staking", + parameters: z.object({ + amount: z + .number() + .positive("Stake amount must be positive") + .min(0.001, "Minimum stake amount is 0.001 SOL"), + }), + execute: async ({ amount }) => { + try { + const tx = await this.solanaKit.stake(amount); + return { + status: "success", + message: "Staked successfully", + transaction: tx, + amount, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaFetchPriceTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.fetchPrice", + description: "Fetch the price of a given token in USDC", + parameters: z.object({ + tokenId: z + .string() + .trim() + .min(1, "Token ID is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid Solana token address"), + }), + execute: async ({ tokenId }) => { + try { + const price = await this.solanaKit.fetchTokenPrice(tokenId); + return { + status: "success", + tokenId, + priceInUSDC: price, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaTokenDataTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.tokenData", + description: "Get the token data for a given token mint address", + parameters: z.object({ + mintAddress: z + .string() + .trim() + .min(1, "Mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid Solana token address"), + }), + execute: async ({ mintAddress }) => { + try { + const tokenData = + await this.solanaKit.getTokenDataByAddress(mintAddress); + return { + status: "success", + tokenData, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaTokenDataByTickerTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.tokenDataByTicker", + description: "Get the token data for a given token ticker", + parameters: z.object({ + ticker: z + .string() + .trim() + .min(1, "Ticker is required") + .max(10, "Ticker too long"), + }), + execute: async ({ ticker }) => { + try { + const tokenData = await this.solanaKit.getTokenDataByTicker(ticker); + return { + status: "success", + tokenData, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaCompressedAirdropTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.compressedAirdrop", + description: "Airdrop SPL tokens with ZK Compression", + parameters: z.object({ + mintAddress: z + .string() + .trim() + .min(1, "Mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid token mint address"), + amount: z.number().positive("Amount must be positive"), + decimals: z + .number() + .int("Decimals must be an integer") + .min(0, "Decimals must be non-negative") + .max(9, "Decimals cannot exceed 9"), + recipients: z + .array(z.string()) + .min(1, "At least one recipient is required") + .refine( + (recipients) => + recipients.every((addr) => { + try { + new PublicKey(addr); + return true; + } catch { + return false; + } + }), + "One or more recipient addresses are invalid", + ), + priorityFeeInLamports: z + .number() + .int("Priority fee must be an integer") + .nonnegative("Priority fee cannot be negative") + .default(30_000), + shouldLog: z.boolean().default(false), + }), + execute: async ({ + mintAddress, + amount, + decimals, + recipients, + priorityFeeInLamports, + shouldLog, + }) => { + try { + const txs = await this.solanaKit.sendCompressedAirdrop( + mintAddress, + amount, + decimals, + recipients, + priorityFeeInLamports, + shouldLog, + ); + return { + status: "success", + message: `Airdropped ${amount} tokens to ${recipients.length} recipients.`, + transactionHashes: txs, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaCreateSingleSidedWhirlpoolTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.createOrcaSingleSidedWhirlpool", + description: "Create a single-sided Whirlpool with liquidity", + parameters: z.object({ + depositTokenAmount: z + .number() + .int("Deposit amount must be an integer") + .positive("Deposit amount must be positive"), + depositTokenMint: z + .string() + .trim() + .min(1, "Deposit token mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid deposit token mint address"), + otherTokenMint: z + .string() + .trim() + .min(1, "Other token mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid other token mint address"), + initialPrice: z.number().positive("Initial price must be positive"), + maxPrice: z + .number() + .positive("Max price must be positive") + .refine((val) => val > 0, "Max price must be greater than 0"), + feeTier: z + .number() + .refine( + (val) => val in FEE_TIERS, + `Invalid fee tier. Available options: ${Object.keys(FEE_TIERS).join(", ")}`, + ), + }), + execute: async ({ + depositTokenAmount, + depositTokenMint, + otherTokenMint, + initialPrice, + maxPrice, + feeTier, + }) => { + try { + const txId = await this.solanaKit.createOrcaSingleSidedWhirlpool( + new BN(depositTokenAmount), + new PublicKey(depositTokenMint), + new PublicKey(otherTokenMint), + new Decimal(initialPrice), + new Decimal(maxPrice), + // @ts-expect-error Value matches type however TS still shows error + feeTier, + ); + + return { + status: "success", + message: "Single-sided Whirlpool created successfully", + transaction: txId, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaRaydiumCreateAmmV4Tool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.raydiumCreateAmmV4", + description: + "Create Raydium's Legacy AMM that requires an OpenBook marketID", + parameters: z.object({ + marketId: z + .string() + .trim() + .min(1, "Market ID is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid market ID"), + baseAmount: z + .number() + .int("Base amount must be an integer") + .positive("Base amount must be positive"), + quoteAmount: z + .number() + .int("Quote amount must be an integer") + .positive("Quote amount must be positive"), + startTime: z + .number() + .int("Start time must be an integer") + .nonnegative("Start time cannot be negative"), + }), + execute: async ({ marketId, baseAmount, quoteAmount, startTime }) => { + try { + const tx = await this.solanaKit.raydiumCreateAmmV4( + new PublicKey(marketId), + new BN(baseAmount), + new BN(quoteAmount), + new BN(startTime), + ); + + return { + status: "success", + message: "Raydium AMM V4 pool created successfully", + transaction: tx, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaRaydiumCreateClmmTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.raydiumCreateClmm", + description: + "Create a Concentrated Liquidity Market Maker (CLMM) pool with custom liquidity ranges", + parameters: z.object({ + mint1: z + .string() + .trim() + .min(1, "First mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid first mint address"), + mint2: z + .string() + .trim() + .min(1, "Second mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid second mint address"), + configId: z + .string() + .trim() + .min(1, "Config ID is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid config ID"), + initialPrice: z.number().positive("Initial price must be positive"), + startTime: z + .number() + .int("Start time must be an integer") + .nonnegative("Start time cannot be negative"), + }), + execute: async ({ mint1, mint2, configId, initialPrice, startTime }) => { + try { + const tx = await this.solanaKit.raydiumCreateClmm( + new PublicKey(mint1), + new PublicKey(mint2), + new PublicKey(configId), + new Decimal(initialPrice), + new BN(startTime), + ); + + return { + status: "success", + message: "Raydium CLMM pool created successfully", + transaction: tx, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaRaydiumCreateCpmmTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.raydiumCreateCpmm", + description: + "Create Raydium's newest CPMM pool (supports Token 2022 standard)", + parameters: z.object({ + mint1: z + .string() + .trim() + .min(1, "First mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid first mint address"), + mint2: z + .string() + .trim() + .min(1, "Second mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid second mint address"), + configId: z + .string() + .trim() + .min(1, "Config ID is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid config ID"), + mintAAmount: z + .number() + .int("Mint A amount must be an integer") + .positive("Mint A amount must be positive"), + mintBAmount: z + .number() + .int("Mint B amount must be an integer") + .positive("Mint B amount must be positive"), + startTime: z + .number() + .int("Start time must be an integer") + .nonnegative("Start time cannot be negative"), + }), + execute: async ({ + mint1, + mint2, + configId, + mintAAmount, + mintBAmount, + startTime, + }) => { + try { + const tx = await this.solanaKit.raydiumCreateCpmm( + new PublicKey(mint1), + new PublicKey(mint2), + new PublicKey(configId), + new BN(mintAAmount), + new BN(mintBAmount), + new BN(startTime), + ); + + return { + status: "success", + message: "Raydium CPMM pool created successfully", + transaction: tx, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaOpenbookCreateMarketTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.openbookCreateMarket", + description: "Create an Openbook market (required for AMM v4)", + parameters: z.object({ + baseMint: z + .string() + .trim() + .min(1, "Base mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid base mint address"), + quoteMint: z + .string() + .trim() + .min(1, "Quote mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid quote mint address"), + lotSize: z.number().positive("Lot size must be positive"), + tickSize: z.number().positive("Tick size must be positive"), + }), + execute: async ({ baseMint, quoteMint, lotSize, tickSize }) => { + try { + const tx = await this.solanaKit.openbookCreateMarket( + new PublicKey(baseMint), + new PublicKey(quoteMint), + lotSize, + tickSize, + ); + + return { + status: "success", + message: "Openbook market created successfully", + transaction: tx, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "UNKNOWN_ERROR", + }; + } + }, + }); + } + + solanaPythFetchPriceTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.pythFetchPrice", + description: + "Fetch the price of a given price feed from Pyth's Hermes service", + parameters: z.object({ + priceFeedID: z + .string() + .trim() + .min(1, "Price feed ID is required") + .regex( + /^0x[a-fA-F0-9]{64}$/, + "Invalid price feed ID format. Must be a 32-byte hex string starting with 0x", + ), + }), + execute: async ({ priceFeedID }) => { + try { + const price = await this.solanaKit.pythFetchPrice(priceFeedID); + return { + status: "success", + priceFeedID, + price, + } as PythFetchPriceResponse; + } catch (e: any) { + return { + status: "error", + priceFeedID, + message: e.message, + code: e.code || "UNKNOWN_ERROR", + } as PythFetchPriceResponse; + } + }, + }); + } + + solanaResolveAllDomainsTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.resolveAllDomains", + description: `Resolve domain names to a public key for ALL domain types EXCEPT .sol domains. + Use this for domains like .blink, .bonk, etc. + DO NOT use this for .sol domains.`, + parameters: z.object({ + domain: z + .string() + .trim() + .min(1, "Domain name is required") + .refine( + (val) => !val.endsWith(".sol"), + "This tool cannot be used for .sol domains. Use solana.resolveDomain instead.", + ) + .refine( + (val) => val.includes("."), + "Invalid domain format. Must include a TLD (e.g., .blink, .bonk)", + ), + }), + execute: async ({ domain }) => { + try { + const owner = await this.solanaKit.resolveAllDomains(domain); + + if (!owner) { + return { + status: "error", + message: "Domain not found", + code: "DOMAIN_NOT_FOUND", + }; + } + + return { + status: "success", + message: "Domain resolved successfully", + owner: owner.toString(), + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "DOMAIN_RESOLUTION_ERROR", + }; + } + }, + }); + } + + solanaGetOwnedDomainsTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.getOwnedDomains", + description: "Get all domains owned by a specific wallet address", + parameters: z.object({ + owner: z + .string() + .trim() + .min(1, "Owner address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid Solana wallet address"), + }), + execute: async ({ owner }) => { + try { + const ownerPubkey = new PublicKey(owner); + const domains = await this.solanaKit.getOwnedAllDomains(ownerPubkey); + return { + status: "success", + message: "Owned domains fetched successfully", + domains, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "FETCH_OWNED_DOMAINS_ERROR", + }; + } + }, + }); + } + + solanaGetOwnedTldDomainsTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.getOwnedTldDomains", + description: + "Get all domains owned by the agent's wallet for a specific TLD", + parameters: z.object({ + tld: z + .string() + .trim() + .min(1, "TLD is required") + .regex( + /^[a-zA-Z0-9]+$/, + "TLD must contain only alphanumeric characters", + ), + }), + execute: async ({ tld }) => { + try { + const domains = await this.solanaKit.getOwnedDomainsForTLD(tld); + return { + status: "success", + message: "TLD domains fetched successfully", + domains, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "FETCH_TLD_DOMAINS_ERROR", + }; + } + }, + }); + } + + solanaGetAllTldsTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.getAllTlds", + description: + "Get all active top-level domains (TLDs) in the AllDomains Name Service", + parameters: z.object({}), + execute: async () => { + try { + const tlds = await this.solanaKit.getAllDomainsTLDs(); + return { + status: "success", + message: "TLDs fetched successfully", + tlds, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "FETCH_TLDS_ERROR", + }; + } + }, + }); + } + + solanaGetMainDomainTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.getMainDomain", + description: "Get the main/favorite domain for a given wallet address", + parameters: z.object({ + owner: z + .string() + .trim() + .min(1, "Owner address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid Solana wallet address"), + }), + execute: async ({ owner }) => { + try { + const ownerPubkey = new PublicKey(owner); + const mainDomain = + await this.solanaKit.getMainAllDomainsDomain(ownerPubkey); + return { + status: "success", + message: "Main domain fetched successfully", + domain: mainDomain, + }; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "FETCH_MAIN_DOMAIN_ERROR", + }; + } + }, + }); + } + + solanaCreateGibworkTaskTool(): CoreTool { + return tool({ + // @ts-expect-error Value matches type however TS still shows error + id: "solana.createGibworkTask", + description: "Create a task on Gibwork", + parameters: z.object({ + title: z + .string() + .trim() + .min(1, "Title is required") + .max(200, "Title too long"), + content: z.string().trim().min(1, "Description is required"), + requirements: z.string().trim().min(1, "Requirements are required"), + tags: z + .array(z.string()) + .min(1, "At least one tag is required") + .max(10, "Maximum 10 tags allowed"), + payer: z + .string() + .trim() + .optional() + .refine((val) => { + if (!val) { + return true; + } + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid payer wallet address"), + tokenMintAddress: z + .string() + .trim() + .min(1, "Token mint address is required") + .refine((val) => { + try { + new PublicKey(val); + return true; + } catch { + return false; + } + }, "Invalid token mint address"), + amount: z + .number() + .positive("Amount must be positive") + .min(0.000001, "Amount must be at least 0.000001"), + }), + execute: async ({ + title, + content, + requirements, + tags, + tokenMintAddress, + amount, + payer, + }) => { + try { + const taskData = await this.solanaKit.createGibworkTask( + title, + content, + requirements, + tags, + tokenMintAddress, + amount, + payer, + ); + + return { + status: "success", + taskId: taskData.taskId, + signature: taskData.signature, + } as GibworkCreateTaskReponse; + } catch (e: any) { + return { + status: "error", + message: e.message, + code: e.code || "CREATE_TASK_ERROR", + }; + } + }, + }); + } +} + +export function createSolanaTools( + solanaKit: SolanaAgentKit, +): Record { + const vercelTools = new VercelAITools(solanaKit); + + return { + solanaBalanceTool: vercelTools.solanaBalanceTool(), + solanaTransferTool: vercelTools.solanaTransferTool(), + solanaDeployTokenTool: vercelTools.solanaDeployTokenTool(), + solanaDeployCollectionTool: vercelTools.solanaDeployCollectionTool(), + solanaMintNFTTool: vercelTools.solanaMintNFTTool(), + solanaTradeTool: vercelTools.solanaTradeTool(), + solanaRequestFundsTool: vercelTools.solanaRequestFundsTool(), + solanaRegisterDomainTool: vercelTools.solanaRegisterDomainTool(), + solanaGetWalletAddressTool: vercelTools.solanaGetWalletAddressTool(), + solanaPumpfunTokenLaunchTool: vercelTools.solanaPumpfunTokenLaunchTool(), + solanaCreateImageTool: vercelTools.solanaCreateImageTool(), + solanaLendAssetTool: vercelTools.solanaLendAssetTool(), + solanaTPSCalculatorTool: vercelTools.solanaTPSCalculatorTool(), + solanaStakeTool: vercelTools.solanaStakeTool(), + solanaFetchPriceTool: vercelTools.solanaFetchPriceTool(), + solanaTokenDataTool: vercelTools.solanaTokenDataTool(), + solanaTokenDataByTickerTool: vercelTools.solanaTokenDataByTickerTool(), + solanaCompressedAirdropTool: vercelTools.solanaCompressedAirdropTool(), + solanaRaydiumCreateAmmV4Tool: vercelTools.solanaRaydiumCreateAmmV4Tool(), + solanaRaydiumCreateClmmTool: vercelTools.solanaRaydiumCreateClmmTool(), + solanaRaydiumCreateCpmmTool: vercelTools.solanaRaydiumCreateCpmmTool(), + solanaOpenbookCreateMarketTool: + vercelTools.solanaOpenbookCreateMarketTool(), + solanaCreateSingleSidedWhirlpoolTool: + vercelTools.solanaCreateSingleSidedWhirlpoolTool(), + solanaPythFetchPriceTool: vercelTools.solanaPythFetchPriceTool(), + solanaResolveDomainTool: vercelTools.solanaResolveDomainTool(), + solanaResolveAllDomainsTool: vercelTools.solanaResolveAllDomainsTool(), + solanaGetDomainTool: vercelTools.solanaGetDomainTool(), + solanaGetOwnedDomainsTool: vercelTools.solanaGetOwnedDomainsTool(), + solanaGetOwnedTldDomainsTool: vercelTools.solanaGetOwnedTldDomainsTool(), + solanaGetAllTldsTool: vercelTools.solanaGetAllTldsTool(), + solanaGetMainDomainTool: vercelTools.solanaGetMainDomainTool(), + solanaCreateGibworkTaskTool: vercelTools.solanaCreateGibworkTaskTool(), + }; +} diff --git a/test/agent_sdks/vercel_ai.ts b/test/agent_sdks/vercel_ai.ts new file mode 100644 index 0000000..789d477 --- /dev/null +++ b/test/agent_sdks/vercel_ai.ts @@ -0,0 +1,196 @@ +import { SolanaAgentKit } from "../../src"; +import { createVercelAITools } from "../../src"; +import { OpenAI } from "openai"; +import * as dotenv from "dotenv"; +import * as fs from "fs"; +import * as readline from "readline"; +import { streamText } from "ai"; +import { createOpenAI } from "@ai-sdk/openai"; +// import { createAI, createStreamableUI, getMutableAIState } from "ai/rsc"; + +dotenv.config(); + +function validateEnvironment(): void { + const missingVars: string[] = []; + const requiredVars = ["OPENAI_API_KEY", "RPC_URL", "SOLANA_PRIVATE_KEY"]; + + 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(); + +async function runAutonomousMode(interval = 10) { + console.log("Starting autonomous mode..."); + const openai = createOpenAI({ + apiKey: process.env.OPENAI_API_KEY as string, + }); + + const solanaAgent = new SolanaAgentKit( + process.env.SOLANA_PRIVATE_KEY!, + process.env.RPC_URL, + process.env.OPENAI_API_KEY!, + ); + + const tools = createVercelAITools(solanaAgent); + + 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 response = streamText({ + prompt: thought, + tools, + model: openai("gpt-4o-mini"), + temperature: 0.7, + system: `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 + (internal) HTTP error code, ask the user to try again later. If someone asks you to do something you + can't do with your currently available tools, you must say so, and encourage them to implement it + 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.`, + maxSteps: 10, + }); + + for await (const textPart of response.textStream) { + process.stdout.write(textPart); + } + 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() { + console.log("Starting chat mode... Type 'exit' to end."); + const openai = createOpenAI({ + apiKey: process.env.OPENAI_API_KEY as string, + }); + + const solanaAgent = new SolanaAgentKit( + process.env.SOLANA_PRIVATE_KEY!, + process.env.RPC_URL, + process.env.OPENAI_API_KEY!, + ); + + const tools = createVercelAITools(solanaAgent); + + const rl = readline.createInterface({ + input: process.stdin, + output: process.stdout, + }); + + const question = (prompt: string): Promise => + new Promise((resolve) => rl.question(prompt, resolve)); + + try { + while (true) { + const userInput = await question("\nPrompt: "); + + if (userInput.toLowerCase() === "exit") { + break; + } + + const response = streamText({ + prompt: userInput, + tools, + model: openai("gpt-4o-mini"), + temperature: 0.7, + system: `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 + (internal) HTTP error code, ask the user to try again later. If someone asks you to do something you + can't do with your currently available tools, you must say so, and encourage them to implement it + 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.`, + maxSteps: 10, + }); + + for await (const textPart of response.textStream) { + process.stdout.write(textPart); + } + 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 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"); + + const choice = (await question("\nChoose a mode (enter number or name): ")) + .toLowerCase() + .trim(); + + rl.close(); + + 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 mode = await chooseMode(); + + if (mode === "chat") { + await runChatMode(); + } else { + await runAutonomousMode(); + } + } 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); + }); +}