Skip to content

rumor-is/.github

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 

Repository files navigation

rumor-git-header

TL;DR

Rumor is a no-code DeFi strategy builder that turns complex, multi-step crypto workflows into one-click, non-custodial actions. Users design strategies visually while Rumor compiles them into a deterministic plan and executes with guardrails. Bridges, routing, gas and multi-chain sequencing are abstracted away. The UX targets gasless usage via ERC-4337 (pay in stablecoins), and emphasizes security, transparency, and auditability.


- why rumor

DeFi is powerful yet fragmented: many chains and UIs, approvals, bridging friction, native-gas hurdles, MEV/slippage risk, and opaque, error-prone flows. Most people don’t have the time or expertise to stitch this together safely. Rumor abstracts the complexity without taking custody, preserves user ownership, and makes execution verifiable end-to-end.


- vision

No-code visual builder. Create strategies from blocks such as Swap, Lend/Borrow, LP, Stake, Bridge, Claim, Wrap/Unwrap, Permit. The result is serialized into a canonical JSON/DAG and bound on-chain by a plan hash.

One-click, chain-abstracted UX. Rumor plans, sequences and bridges across networks automatically so the user never handles chain switching, approvals per step, or gas on the target chain.

Non-custodial by design. Funds live in user-owned smart accounts with direct escape hatches; Rumor never takes custody.

Gasless experience. ERC-4337 + Token Paymaster aims for stablecoin-denominated fees; users avoid “you need native gas on chain X”.

Unified Withdraw. Unwind multi-chain positions back to a target asset/chain in a single action with clear status and partial-completion handling.

Progressive risk disclosure. Green / Amber / Red profiles with caps, quizzes and explicit acknowledgements.


- rumor enables

One-click base strategies (lend, LP, stake) with clear estimates and guardrails; yield rotation and rebalancing across protocols and chains; auto-compound and schedulers with minimum gain thresholds; cross-chain operations (bridge → swap → deploy) managed as one plan; private strategies that reveal only a plan hash while keeping the JSON off-chain with access control.


- design principles

Security-first & minimal trust. Immutable user accounts, protocol allow-lists, scoped pauses and audited adapters.

Modularity & extensibility. A unified adapter interface and registries enable safe onboarding of protocols with risk tags.

Exactly-once semantics. Idempotent inbox/outbox with GUIDs and nonces, double-ACK transport checks, and saga-style compensations.

MEV-aware execution. Deadlines, minOut, pre-simulation, private relays for sensitive steps, and re-validation at destination.

Progressive decentralization. Clear path from multisig+timelock toward on-chain governance.


High-Level Architecture

rumor-is User plane (Web App, API/BFF, Visual Builder) → Orchestration (Intent Resolver / Tx-Manager, Cross-chain Orchestrator, Strategy Storage, Route & Gas Quoter) → Data (Indexer & Portfolio, Observability) → On-chain per chain (ProxyFactory, ProxyAccount, StrategyExecutor (Diamond), Adapter & Risk registries, Token Paymaster) + external bridges/messaging, price oracles, AA Bundler/EntryPoint, IPFS/Arweave.

- on-chain components (Overview)

ProxyFactory & ProxyAccount (per user, per chain)

Minimal, non-upgradeable smart accounts holding user funds. Authorization via owner/multisig and an executor allow-list. Idempotent message intake and reentrancy protection. Direct withdrawal (escape hatch) keeps users in control even under degraded conditions.

StrategyExecutor (EIP-2535 Diamond)

A shared per-chain executor with facets such as Swap, LendBorrow, StakeReward, Bridge, Admin. Centralized parameter validation (slippage, deadlines, price sanity) and hardened external calls (gas caps, return-data checks). Facet-level pausing enables fine-grained safety responses.

Adapter Layer & Registries

Thin adapters implement a common interface for quotes and calldata construction. The Adapter Registry stores addresses, versions and audit tags; the Risk Config sets TVL caps, slippage ceilings and per-protocol/chain limits. Version quarantine, canary rollout and security sentinels reduce integration risk.

Token Paymaster (ERC-4337)

Sponsored gas in stablecoins with quotas and TTLs. Accounting-only postOp and a reserve-on-start with final true-up settlement policy minimize UX friction while bounding platform risk.


- off-chain & orchestration (Overview)

Intent Resolver / Tx-Manager.

Compiles the visual graph into a deterministic plan and materializes route/bridge choices before the first on-chain step.

Cross-chain Orchestrator.

Sequences dependent steps and parallelizes independent ones; tracks GUID/planHash/stepIdx, retries/timeouts and performs saga compensations on failure.

Route & Gas Quoter.

Quotes with TTL, deadlines and minOut; MEV-aware routing with private relays where needed.

Strategy Storage Gateway.

Plan JSON on IPFS (optional Arweave backup); on-chain binding via plan hash; optional encryption/ACL.

Indexer & Portfolio.

Cross-chain correlation of events and aggregation of balances/positions; pending remainders and execution state surfaced to the UI. Observability monitors SLOs (T99 by class), stuck-age thresholds, paymaster spend, bridge/DVN health and oracle heartbeat/deviation.

Safety & Risk Controls

Risk profiles and caps per user/strategy/chain; per-protocol/chain TVL limits and global ceilings. Oracle policy with primary/secondary feeds, max age and deviation bounds (short TWAP where applicable). Bridge security with route allow-lists, per-tx caps, split-routing for size tiers, stuck-age auto-pauses and provider diversification. Scoped circuit breakers (ERC-7265-like) allow pausing by scope (global / chain / protocol / asset / selector). Unified Withdraw and direct ProxyAccount withdrawals remain available under incident response.


- roadmap (Phased)

P0 - Single-chain foundation: proxy accounts, shared Diamond executor, Aave/Uniswap adapters, demo 50/50 strategy. (Already finished)
P1 - Multi-strategy (single chain): adapter expansion (10–20 blue-chips), AA/Paymaster UX hardening, simulation/quoting.
P2 - Cross-chain MVP (2–3 chains): messaging adapter with failover, bridge policy, settlement on funding chain, observability/alerts.
P3 - Visual Builder (Manual/Assisted): deterministic serialization and marketplace-ready strategy templates.
P4 - Scale-out & Governance: more chains/protocols, audits/bug bounty, Safe+Timelock → Governor.


- status & demo

Today: production-ready demo on mainnet (current MVP runs on Polygon with Aave v3 & Uniswap v3 integration), shared executor and per-user proxies.

Try it live: rumor.fi - connect a wallet and run the demo strategy with a small amount.

Next: multi-strategy support and cross-chain expansion starting with low-cost L2s.


- contributing / feedback

Issues and PRs are welcome. If you’re integrating a protocol adapter or proposing a strategy template, please open an issue with the target chain, contracts and risk notes.


- security & disclaimer

This is experimental, non-custodial software. No warranties. Not financial advice. Use amounts you can afford to lose. DeFi carries risks (smart contracts, oracles, liquidity, bridges, market condi

About

The DeFi Strategy Engine - Like n8n for crypto investments.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published