How to Test it out

Testing the Sui Agent Kit helps confirm that all functionalities are working as intended. You can perform automated tests or interact with the agent in various modes to validate its operations.

Running Automated Tests

The project includes a test script located at test/index.ts. To execute the tests:

  1. Ensure Dependencies are Installed If you haven’t installed the dependencies yet, refer to the Setup Locally guide.

  2. Run the Test Script

pnpm run test

This will run the test/index.ts script using ts-node. Ensure that your environment variables are correctly set in the .env file before running the tests.

Interactive Modes

Available Modes

  1. Chat Mode Allows you to interact with the agent in a conversational manner.
  2. Autonomous Mode Enables the agent to perform actions on the blockchain autonomously at regular intervals.

Starting the Agent

  1. Launch the Agent
pnpm start
  1. Select Your Mode
  • For Chat Mode: Enter 1 or chat
  • For Autonomous Mode: Enter 2 or auto

Using Each Mode

Chat Mode

  • Start chatting by entering prompts after the Prompt: indicator
  • Type exit to end the chat session

Autonomous Mode

  • The agent executes predefined actions every 10 seconds
  • Actions and outputs are displayed in the console

Best Practices

Environment Setup

  • Verify .env file contains correct and secure values
  • Ensure all required environment variables are set

Testing

  • Maintain comprehensive test coverage
  • Monitor console logs during testing
  • Clean up test assets after deployment

Troubleshooting

Test Failures

Missing Environment Variables

  • Issue: Tests fail due to missing environment variables
  • Solution: Check .env file for all required variables

Network Problems

  • Issue: Network-related errors
  • Solution: Verify internet connection and Solana RPC endpoint accessibility

Agent Issues

Startup Problems

  • Issue: Agent doesn’t prompt for mode selection
  • Solution: Verify successful build and dependency installation