Skip to main content

​
Flow of Funds Overview

RebelFi operates as a non-custodial orchestration layer that optimizes your stablecoin operations while you maintain complete control over custody and execution.
Key Principle: RebelFi never holds your private keys or controls your funds. We generate optimized transaction strategies which your custody solution executes.

​
The Five-Step Process

​
Step 1: Monitor & Analyze

RebelFi monitors your designated stablecoin wallets for:
  • Balance changes and inbound transactions
  • Deployed allocation performance
  • Buffer levels and liquidity requirements
Based on configured parameters (buffer amounts, yield enablement), our engine continuously analyzes optimization opportunities.

​
Step 2: Generate Operations

When optimization opportunities arise, RebelFi creates Operations — structured workflows that describe business intent:
  • Supply Operations: Deploy idle funds to yield-generating protocols
  • Disburse Operations: Withdraw funds from yield back to operational wallets
  • Rebalance Operations: Shift allocations between protocols for optimal returns
Each operation includes:
  • Financial reservations (locks on available balances)
  • Multi-step execution plans
  • Expected blockchain transactions
  • State management and tracking

​
Step 3: Your Review & Approval

Operations can be configured for:
Operations proceed automatically for hands-off yield optimizationBest for: Trusted operational flows, yield-only deployments

​
Step 4: Custody Integration & Execution

RebelFi integrates with your custody solution through flexible patterns that fit your infrastructure:
Integration TypeHow It WorksBest For
Agent PollingDeploy your own agent or use RebelFi’s managed agent to poll for transactions, sign them, and report execution statusMaximum control, any custody solution, custom infrastructure
Direct APIProvide custody API credentials (e.g., Fireblocks API key) and RebelFi submits transactions directly to your custody providerStreamlined workflow with API-first custody providers like Fireblocks, BitGo
Custom AdapterWork with RebelFi to build custom integration for home-grown or specialized custody solutionsProprietary custody systems, unique requirements
All integration patterns ensure you maintain complete signing authority. RebelFi cannot execute transactions without your custody solution’s approval and signature.
Example: Agent Polling Flow 
// Agent polls for pending transactions
const pollResponse = await rebelfi.agent.transactions.poll({
  leaseDurationMs: 30000
});

if (pollResponse.transaction) {
  // Sign with your custody solution
  const signedTx = await custodySolution.sign(pollResponse.transaction.unsignedTx);

  // Submit to blockchain
  const txHash = await blockchain.submit(signedTx);

  // Report back to RebelFi
  await rebelfi.agent.transactions.report(pollResponse.transaction.id, {
    status: 'SUBMITTED',
    txHash: txHash
  });
}

​
Step 5: Track & Confirm

RebelFi’s monitoring system:
  1. Observes blockchain for transaction confirmation
  2. Matches confirmed transactions to expected operations
  3. Updates financial state (reservations → allocations)
  4. Tracks yield accrual and performance

​
Non-Custodial Design

Your custody provider holds keys → RebelFi generates operation plans → your custody signs & broadcasts → blockchain settles → RebelFi tracks confirmation and updates state.

​
Operation Lifecycle

PLANNING → PENDING_APPROVAL → EXECUTING → CONFIRMING → COMPLETED
  • PLANNING: Reservation locked
  • PENDING_APPROVAL: Awaiting manual approval (if required)
  • EXECUTING: Signing by custody
  • CONFIRMING: Awaiting on-chain confirmation
  • COMPLETED: Financial state updated

​
Financial State Management

Double-entry ledger with: Reservations (temporary locks), Expected Receipts (matched on arrival), Journal Entries (immutable), Positions (read-optimized balances), Allocations (deployed funds earning yield).
StageAvailableReservedDeployed
Initial10,000 USDC——
Operation created5,000 USDC5,000 USDC—
Confirmed5,000 USDC—5,000 USDC

​
Security Model

​
Zero Trust Architecture

RebelFi is designed with zero trust principles:
  • No Key Access - We cannot access your private keys under any circumstances
  • No Fund Control - We cannot move funds without your custody solution signing
  • No Direct Execution - All transactions require your explicit signing authority
  • Complete Audit Trail - Every operation, reservation, and state change is logged

​
Transaction Safety

Operations include safety mechanisms:
  • Atomic Reservations: Funds are locked during operations to prevent double-spending
  • Idempotency: Operations can be safely retried without duplicate effects
  • State Validation: Each state transition is validated against allowed progressions
  • Timeout Handling: Operations that don’t complete within timeframes are automatically released

​
Protocol Vetting

Yield protocols are carefully evaluated for:
  • Smart contract audits
  • Historical performance and uptime
  • Total value locked (TVL)
  • Institutional usage
  • Risk-adjusted returns
Initially, RebelFi focuses on battle-tested protocols with institutional adoption and comprehensive audit histories.

​
Multi-Blockchain Support

RebelFi supports multiple blockchain networks:
  • Solana - Native SPL token support, sub-second finality
  • EVM Chains - Ethereum, Base, Arbitrum, Polygon (coming soon)
Blockchain adapters provide:
  • Unified address monitoring
  • Chain-specific transaction building
  • Cross-chain balance aggregation
  • Protocol abstraction

​
Next Steps

Quick Start

Integrate RebelFi in 10 minutes

Custody Integration

Set up your custody agent