handoff-contract

Smart contract workspace for Handoff's Mantle deployment flow.

The broader product direction is:

AI Trading & Strategy — AI quant bots and macro-driven smart contracts, with Python and Solidity templates and Bybit API support.

AI x RWA — Dynamic yield strategies and automated risk management for assets including USDY and mETH, built on Mantle's RWA infrastructure.

This repository is intended to support the onchain side of a node-based strategy product inspired by n8n-style editing, where users can configure and update automated strategy behavior through composable workflow nodes, with a particular focus on:

• macro-driven Solidity execution patterns
• RWA yield and risk-management contracts on Mantle
• backend-linked strategy systems that may also rely on Python agent templates and Bybit-connected trading logic offchain

Product Direction

Handoff is being shaped around two linked product tracks:

• AI Trading & Strategy for quant bots, execution logic, and macro-aware automation
• AI x RWA for dynamic yield strategies and automated risk management on Mantle

Initial assumptions for this contract workspace:

• users define strategy behavior through editable node flows
• strategies may route across assets such as USDY and mETH
• AI assists with monitoring, evaluation, and strategy adjustment suggestions
• contracts act as the execution and registry layer for approved strategy logic
• Solidity templates should remain easy to pair with Python agent templates and exchange-facing infrastructure such as Bybit integrations
• Mantle is the primary target environment for RWA deployment and iteration

This project does not yet implement the full protocol logic. Right now it provides a clean Hardhat foundation for:

• prototyping registry and execution contracts
• testing Mantle deployment flows
• iterating on macro-driven and AI-assisted smart contract primitives
• connecting future offchain AI, Python strategy agents, and workflow systems to onchain execution

Current Scope

The current scaffold includes:

• a Hardhat project configured for Mantle and Mantle Sepolia
• a sample Solidity contract (HandoffRegistry.sol)
• a sample deploy script
• a basic test suite

Use this as the base layer before adding:

• strategy registries
• workflow-to-contract permissioning
• execution policies
• risk guardrails
• asset adapters
• automation hooks for offchain agents or node-based orchestration

Setup

1. Copy .env.example to .env
2. Fill PRIVATE_KEY and RPC values as needed
3. Install dependencies if not already installed:

npm install

Commands

• npm run compile
• npm test
• npm run deploy:mantle-sepolia
• npm run deploy:mantle

Networks

• mantle -> chainId 5000
• mantleSepolia -> chainId 5003

Suggested Next Steps

Natural next additions for this repository:

1. replace the sample registry with a strategy registry contract
2. define how workflow nodes map to executable onchain actions and macro-driven contract behaviors
3. add role or signature-based controls for AI-assisted updates
4. model risk constraints for supported RWA assets such as USDY and mETH
5. add deployment and verification scripts for Mantle environments and clean integration points for backend strategy runners