Agent is an experimental protocol project exploring collateralized synthetic assets. The repository is being built in verifiable milestones; features are documented as available only after their source code and tests are committed.
MockOracle.sol: mutable local/testnet oracle with 8-decimal prices.- Hardhat 3 contract compilation, TypeScript tests, and Ignition deployment.
- React status page.
- GitHub Actions checks.
Collateral custody, debt accounting, liquidation, synthetic-equity issuance, production oracle integrations, route reserves, governance, audits, and mainnet deployments are not implemented.
- Node.js 22.13.0 or newer
- npm 10 or newer
npm installCommit the generated package-lock.json. After that, CI and fresh clones should use:
npm cinpm run check
npm run audit:runtimeThe first command runs linting, Solidity compilation, TypeScript checking, contract tests, and the frontend production build. The second checks production/runtime dependencies for high-severity advisories.
npm run devnpm run contracts:deploy:localCopy .env.example to .env, enter test-only credentials, and run:
npm run contracts:deploy:sepoliaNever use a wallet that controls real funds. Values prefixed with VITE_ are public browser configuration and must never contain secrets.
contracts/ Solidity source
contracts/interfaces/ Shared contract interfaces
contracts/mocks/ Local and testnet-only contracts
test/ TypeScript smart-contract tests
ignition/modules/ Declarative deployments
src/ React frontend
docs/ Architecture and security documentation
.github/workflows/ Continuous integration
Read SECURITY.md and docs/THREAT_MODEL.md. There is no audit or bug bounty yet.
MIT
