Automate USDC Balance Management with 1Shot API and Telegram

This n8n workflow simplifies and automates the process of managing USDC balances between a wallet and Aave using the 1Shot API, with notifications delivered via Telegram. It allows for conditional logic to decide on actions based on certain criteria, providing a flexible and responsive automation solution.

What it does

This workflow provides a robust framework for conditional automation and notification:

1. Manual or Scheduled Trigger: The workflow can be initiated manually by clicking "Execute workflow" or automatically at scheduled intervals.
2. Conditional Logic (Switch): It uses a Switch node to route the workflow based on specific conditions, allowing for different paths of execution.
3. Further Conditional Logic (If): Depending on the initial Switch node's outcome, an If node provides another layer of conditional branching (True/False).
4. Code Execution: A Code node is included, allowing for custom JavaScript logic to be executed at a specific point in the workflow, likely for data manipulation or API calls (e.g., interacting with the 1Shot API for USDC balance checks or transfers).
5. Merge Paths: A Merge node combines different execution paths back into a single stream, ensuring that subsequent actions can process consolidated data.
6. Telegram Notifications: Finally, the workflow sends messages or alerts to a Telegram chat, providing real-time updates or notifications about the USDC balance management process.
7. Informational Sticky Note: A Sticky Note provides additional context or instructions within the workflow itself.

Prerequisites/Requirements

• n8n Instance: A running n8n instance to host and execute the workflow.
• Telegram Bot Token: A Telegram bot token and the chat ID where notifications should be sent. This will need to be configured as a credential in n8n for the Telegram node.
• 1Shot API Access: Although not explicitly configured in the provided JSON, the workflow's context suggests interaction with the 1Shot API for USDC balance management. Any necessary API keys or authentication details for 1Shot would be required within the Code node or a dedicated HTTP Request node (if added).
• JavaScript Knowledge: For customizing the Code node to interact with the 1Shot API or perform specific calculations.

Setup/Usage

1. Import the Workflow:
   • Save the provided JSON content as a .json file.
   • In your n8n instance, go to "Workflows" and click "New".
   • Click the "Import from JSON" button and select the saved JSON file.
2. Configure Credentials:
   • Locate the "Telegram" node.
   • Click on the "Credential" field and select an existing Telegram API credential or create a new one by providing your Telegram Bot Token.
   • Ensure the Chat ID in the Telegram node is correctly set to receive notifications.
3. Customize Logic:
   • Switch Node: Configure the conditions in the "Switch" node (ID: 112) to define the initial branching logic based on your requirements.
   • If Node: Adjust the conditions in the "If" node (ID: 20) for the secondary level of conditional processing.
   • Code Node: Edit the "Code" node (ID: 834) to include your specific JavaScript logic. This is where you would integrate with the 1Shot API to check balances, initiate transfers, or perform other USDC-related actions. You might need to add HTTP Request nodes if direct API calls are preferred over custom code.
4. Set Trigger:
   • Choose between the "Manual Trigger" (ID: 838) for manual execution or configure the "Schedule Trigger" (ID: 839) to run the workflow automatically at desired intervals (e.g., every hour, daily).
5. Activate the Workflow: Once configured, activate the workflow by toggling the "Active" switch in the top right corner of the workflow editor.