lucky-raffle-agent-teneo

What This Skill Does

The Lucky Raffle Agent, powered by Teneo Protocol, is a decentralized, payment-based raffle system that allows users to participate in automated prize draws directly through AI interactions. By leveraging Teneo's decentralized network of AI agents, this skill provides a transparent, secure environment for engaging in raffles. It uses blockchain technology to manage entries and verify eligibility, ensuring that all participants interact with valid USDC contracts on supported networks like Base, Peaq, and Avalanche. Users communicate with the agent via standard messaging, enabling a seamless Web3 experience that bridges AI automation with on-chain financial transactions.

Installation

To integrate the Lucky Raffle Agent, you must first have the Teneo SDK installed in your Node.js environment. Begin by executing npm install @teneo-protocol/sdk dotenv in your project terminal. Ensure you have Node.js 18 or higher. You must configure your environment with a compatible Ethereum wallet to authorize the USDC transactions required for participation. Once the SDK is initialized with your chosen network (e.g., Base, Peaq, or Avalanche) and the corresponding USDC contract address, you can connect to the Teneo WebSocket to start sending commands to the raffle agent.

Use Cases

This skill is ideal for community engagement, promotional campaigns, and gamified dApp experiences. Project owners can use it to incentivize user activity by hosting periodic raffles with USDC prizes. It is also a perfect tool for developers learning to implement Web3 payment flows into AI agents, serving as a functional reference for integrating on-chain asset transfers into conversational user interfaces.

Example Prompts

1. "@raffle-agent raffle info"
2. "@raffle-agent participate"
3. "@raffle-agent raffle info - can you show me the current pool status?"

Tips & Limitations

Always ensure your wallet has sufficient USDC balance before attempting to join a raffle to avoid transaction failures. Because this agent handles real financial transactions, double-check that you are connected to the correct network (e.g., Base eip155:8453) defined in the SDK. Note that the agent relies on the Teneo protocol WebSocket; if network latency is high, command confirmation may be delayed. Since this agent uses on-chain verification, all entries are final once the transaction is signed, so verify all details via the 'info' command before proceeding.