How omsant02/3sips works
Project Type and Purpose
• This is a full-stack, blockchain-centric application combining:
• A Node.js/TypeScript AI agent (sip-agent)
• A React/Web3 frontend
• On-chain smart contracts (in the top-level contracts folder)
• Purpose: Provide an autonomous AI-driven, cross-chain crypto investment platform (3SIPS) that leverages ElizaOS for natural-language interaction, Chainlink Automation for scheduled actions, and Avalanche subnets for fund distribution.
File-Structure Analysis
• Top level
• contracts/ → Solidity smart contracts (ERC20 token, home & remote contracts).
• sip-agent/ → Agent service & frontend mono-repo managed by Bun & Vite.
• sip-agent/src
• frontend/ → React UI (index.tsx, index.html, styles)
• actions/ → Business logic for SIP operations
• services/web3Service.ts → Blockchain interaction via ethers.js
• index.ts & plugin.ts → Agent entrypoints and plugin scaffolding
• types/contracts.ts → TypeScript interfaces for on-chain contracts
• Config & scripts
• bunfig.toml, tsconfig.json, vite.config.ts, tsup.config.ts → Build and dev toolchain
• scripts/ */test-all.sh, install-test-deps.js → CI and test orchestration
• Tests
• __tests__/unit, integration, e2e & Cypress component/e2e tests cover UI and agent logic.
README Insights
• Architecture section shows high-level flow:
User → ElizaOS AI Agent → Chainlink Automation → Smart Contracts → Multi-Chain Distribution
• Describes three Avalanche subnets: Fuji (30%), Echo (60%), Dispatch (10%)
• Technical stack: ElizaOS, Chainlink, Avalanche ICTT, Solidity, Node.js/TypeScript, React, ethers.js