Why Chose Lit and Vincent ?

Vincent & Lit Protocol

What is Lit Protocol?

Lit Protocol is a decentralized key management network that enables programmable signing and encryption. It powers the Vincent framework, which SaucerHedge uses for non-custodial automation.

Key Concepts

PKPs (Programmable Key Pairs)

A PKP is like a smart wallet that can:

• Hold assets securely

• Execute transactions programmatically

• Operate within defined permissions

• Remain under user control

Think of it as:

Traditional Wallet: You manually sign every transaction
PKP Wallet: You program rules, it executes automatically

Vincent Framework

Vincent is Lit Protocol's framework for building AI-powered automation agents that:

• Execute actions on behalf of users

• Operate within strict permission scopes

• Maintain non-custodial security

• Provide full transparency

How SaucerHedge Uses Vincent

The Architecture

Your Wallet (HashPack)
      │ You sign once to grant permissions
      ↓
PKP Vault (Lit Network)
      │ Your assets, your control
      ↓
Vincent Abilities
      │ Automated execution
      ├─ HederaLPManagerAbility
      ├─ HederaHedgeAbility
      ├─ HederaHTSAbility
      └─ HederaConsensusAbility
      ↓
Smart Contracts
      │ Execute strategies
      └─ SaucerHedger, SaucerSwap, Bonzo

Custom Hedera Abilities

SaucerHedge implements four custom Vincent abilities:

1. HederaLPManagerAbility

Manages SaucerSwap V2 positions:

// Pseudocode
ability HederaLPManager {
  - mintPosition()      // Open new LP
  - burnPosition()      // Close LP
  - collectFees()       // Claim trading fees
  - increaseLiquidity() // Add more capital
  - decreaseLiquidity() // Remove capital
}

What it does:

• Opens concentrated liquidity positions

• Manages tick ranges

• Collects and compounds fees

• Adjusts liquidity as needed

2. HederaHedgeAbility

Manages hedging positions on Bonzo:

ability HederaHedge {
  - openShortPosition()   // Create hedge
  - closeShortPosition()  // Exit hedge
  - rebalanceHedge()      // Adjust ratio
  - liquidationGuard()    // Prevent liquidation
}

What it does:

• Opens leveraged short positions

• Monitors health factor

• Rebalances hedge ratio

• Prevents liquidations

3. HederaHTSAbility

Handles Hedera Token Service operations:

ability HederaHTS {
  - associateToken()    // Enable HTS token
  - transferHTS()       // Native transfers
  - wrapToERC20()       // HTS → EVM
  - unwrapFromERC20()   // EVM → HTS
  - batchOperations()   // Gas efficiency
}

What it does:

• Seamless HTS integration

• Token associations

• Efficient batch operations

• Cross-standard bridging

4. HederaConsensusAbility

Records actions on Hedera Consensus Service:

ability HederaConsensus {
  - logPositionOpen()      // Record new position
  - logRebalance()         // Record adjustments
  - logDelegationChange()  // Record scope changes
  - queryAuditTrail()      // Read history
}

What it does:

• Immutable audit trail

• Transparent logging

• Historical queries

• Compliance support

Delegation Scope: Your Safety Net

The delegation scope defines exactly what Vincent can do:

Example Scope

{
  // Which contracts can be called
  allowedContracts: [
    "0x123...abc", // SaucerHedger
    "0x456...def", // SaucerSwap V2
    "0x789...ghi"  // Bonzo Finance
  ],
  
  // Which functions can be executed
  allowedFunctions: [
    "openHedgedLP",
    "rebalance",
    "closePosition",
    "collectFees"
  ],
  
  // Transaction limits
  limits: {
    maxSingleTx: "5000 USDC",
    dailyLimit: "20000 USDC",
    monthlyLimit: "100000 USDC"
  },
  
  // Approval thresholds
  approvals: {
    requireApprovalAbove: "10000 USDC",
    alwaysRequire: [
      "withdrawFunds",
      "changeScope"
    ]
  },
  
  // Time constraints
  timing: {
    minTimeBetweenTx: 300,      // 5 minutes
    maxDailyOperations: 20,
    pauseDuringVolatility: true
  },
  
  // Emergency controls
  emergency: {
    pausable: true,
    circuitBreaker: true,
    emergencyWithdrawal: true
  }
}

How Scope Protection Works

User wants to: Rebalance position
Vincent checks:
  ✓ Is 'rebalance' in allowedFunctions?
  ✓ Is amount < maxSingleTx?
  ✓ Is time since last tx > minTimeBetweenTx?
  ✓ Is target contract in allowedContracts?
  ✓ Are all safety checks passed?
  
If all ✓: Execute transaction
If any ✗: Request user approval

Security Model

Three Layers of Control

Layer 1: Wallet Level

• You own the private key

• Can revoke all permissions instantly

• Vincent has zero access to wallet

Layer 2: PKP Level

• PKP holds assets

• Controlled by your wallet signature

• Cannot be accessed by Vincent without permission

Layer 3: Scope Level

• Defines what Vincent can do

• Enforced by smart contracts

• Immutable until you change it

Trust Model

Trust Required: ZERO

Why?
├─ No custody of funds (you control PKP)
├─ Defined scope limits actions
├─ All actions logged on HCS
├─ Open source code
└─ Can revoke anytime

Vincent vs. Traditional Bots

Traditional Bot Architecture

User
  ↓ Give private keys (DANGEROUS!)
Bot Service
  ↓ Full control of funds
Smart Contracts
  
Problems:
❌ Custodial risk
❌ Black box execution
❌ Trust required
❌ Single point of failure

Vincent Architecture

User
  ↓ Define scope (SAFE!)
PKP Vault
  ↓ Assets remain yours
Vincent Abilities
  ↓ Execute within scope
Smart Contracts

Benefits:
✅ Non-custodial
✅ Transparent execution
✅ No trust needed
✅ User always in control

How PKPs Work Technically

PKP Generation

1. User requests PKP creation
   ↓
2. Lit Network generates key pair
   ├─ Public key → PKP address
   └─ Private key → Distributed across Lit nodes
   ↓
3. No single entity has full private key
   ↓
4. Threshold signing (51% of nodes needed)
   ↓
5. You control via your wallet signature

Transaction Signing

1. Vincent needs to execute transaction
   ↓
2. Checks delegation scope
   ↓
3. If allowed:
   ├─ Request signature from Lit Network
   ├─ Lit nodes verify scope
   ├─ 51% of nodes sign
   └─ Transaction executed
   ↓
4. If not allowed:
   └─ Request user approval

Benefits for SaucerHedge Users

1. Automation Without Risk

Traditional: Give up control for automation
SaucerHedge: Keep control, get automation

2. Fine-Grained Permissions

You decide:
- Which contracts
- Which functions
- How much value
- When to execute
- What requires approval

3. Transparent Execution

Every action:
✓ Logged to HCS
✓ Visible on-chain
✓ Verifiable by anyone
✓ Immutable record

4. Instant Revocation

Unhappy with something?
→ Revoke PKP permissions
→ Instant effect
→ Vincent stops immediately
→ You maintain full access to funds

Practical Example

Opening a Position

Without Vincent (Manual):

Day 1: Open LP position ($50 gas)
Day 3: Check if rebalance needed
Day 5: Manually rebalance ($50 gas)
Day 7: Collect fees ($50 gas)
Day 9: Check if rebalance needed
...repeat forever

Cost: $50+ per operation
Time: Hours of monitoring
Risk: Miss optimal times

With Vincent (Automated):

Day 0: Set delegation scope (one-time)
Day 0: Open position via Vincent ($0.0003)

Then automatically:
- Monitor every 5 minutes
- Rebalance when needed ($0.0002 each)
- Collect & compound fees ($0.0002)
- Alert on important events
- Close at boundaries

Cost: $0.0003 per operation
Time: Zero manual work
Risk: Optimal execution always

Advanced: Building Custom Abilities

Developers can create custom Vincent abilities:

import { LitAbility } from '@lit-protocol/lit-abilities';

class MyCustomAbility extends LitAbility {
  name = 'MyCustomStrategy';
  
  async execute() {
    // Check scope
    await this.checkScope(...);
    
    // Your custom logic
    const result = await this.customStrategy();
    
    // Log to HCS
    await this.logAction(...);
    
    return result;
  }
}

See Developer Guide for details.

Limitations & Considerations

What Vincent CAN'T Do

❌ Access your wallet directly ❌ Change scope without your approval ❌ Execute outside defined scope ❌ Withdraw funds without permission ❌ Override your revocations

What You Should Know

⚠️ Vincent operates within scope - carefully define limits ⚠️ PKP creation is one-way - cannot be "un-created" ⚠️ Scope changes require transaction ⚠️ Network fees still apply (though very low on Hedera)

Comparison: Vincent vs. Other Solutions

Feature	Vincent	Gelato	Chainlink Automation	Traditional Bot
Custody	Non-custodial	Non-custodial	Non-custodial	Custodial
Scope Control	Granular	Limited	Limited	None
Transparency	Full	Partial	Full	None
Cost (Hedera)	$0.0003	$0.001+	$0.01+	Varies
Custom Logic	Yes	Limited	Limited	Yes
Audit Trail	HCS	On-chain	On-chain	Off-chain

Getting Started with Vincent

For Users

1. Connect Wallet → HashPack/Kabila

2. Create PKP → One click in SaucerHedge

3. Set Scope → Define your limits

4. Deposit Assets → To PKP vault

5. Enable Automation → Vincent takes over

For Developers

1. Study Abilities → Review our implementations

2. Read SDK Docs → Lit Protocol documentation

3. Build Custom Logic → Create new abilities

4. Test Thoroughly → Testnet first

5. Deploy → Integrate with SaucerHedge

Resources

• Lit Protocol Documentation

• Vincent Framework Guide

• SaucerHedge Abilities