# Underscore Protocol

Your Money Never Sleeps

One protocol. Two products.

1. [**Earn Vaults**](/earn-vaults/vaults) — two yield profiles built on the same share-based architecture: Core Vaults for passive AI-managed yield, and Amplified Vaults for Ripe-powered yield amplification.
2. [**Programmable Wallets**](/programmable-wallets/user-wallet) — Agentic wallets where AI agents and operators pay, rebalance, and move funds within your rules. No custody. No private keys. No unrestricted access.

Your funds earn while you sleep. No manual management. No missed opportunities.

***

## Earn Vaults

Underscore Earn Vaults come in two forms:

* **Core Vaults** — AI-managed passive yield wrapped into standard ERC-4626 shares
* **Amplified Vaults** — built on top of Core Vault shares using Ripe to add a second yield layer with USD-based debt safety

Deposit assets, receive Earn Vault shares, and let the strategy run underneath.

* **Composable** — Earn Vault shares work anywhere in DeFi: trade them, bridge them, use as collateral
* **Productive collateral** — Borrow on Ripe while your collateral keeps earning yield
* **Scalable** — 100,000 users share one strategy. AI rebalances once. Everyone benefits.

**Perfect for:** Passive yield seekers, protocols needing productive collateral, and apps adding straightforward or amplified yield features

**→ Learn more:** [**Earn Vaults: Core Vaults and Amplified Vaults**](/earn-vaults/vaults)

***

## Programmable Wallets: Money For Agents

Most agents can recommend. Underscore lets them execute — with real funds, without ever holding your private keys.

Programmable Wallets give AI agents and operators onchain execution rights within strict boundaries. [Managers](/programmable-wallets/managers) define permissions. [Payees](/programmable-wallets/payees) handle recurring spend. [Digital Cheques](/programmable-wallets/cheques) handle one-off payments with optional review delays. Everything is enforced onchain by smart contracts.

### [Managers: Give Agents Execution Rights, Not Custody](/programmable-wallets/managers)

Authorize agents to manage yield, swap, borrow, repay, claim rewards, and pay. Restrict by asset, protocol, budget, cooldown, expiry.

* **Granular permissions** — Allow only what you specify
* **Hard spending limits** — Daily, monthly, and lifetime caps
* **Time-based controls** — Auto-expire after set periods
* **Instant revocation** — Your control is absolute

*Example: A yield agent can rebalance across Aave, Morpho, and Euler with a $25,000 daily limit.*

### [Payees: Let Agents Pay for the Services They Need](/programmable-wallets/payees)

Pre-approve recurring recipients like market data feeds, model providers, compute vendors, contractors, payroll, subscriptions. Set per-payment caps, period limits, allowed assets, cooldowns.

* **Pre-approved recipients** with individual limits
* **Automated payments** while funds earn yield
* **Pull payment support** for subscriptions and service fees
* **Period-based caps** preventing overspending

*Example: Your trading agent keeps its data feed, inference API, and GPU provider online with fixed USDC allowances.*

### [Digital Cheques: One-Off Spend Without Blind Trust](/programmable-wallets/cheques)

Turn transfers into controlled payment commitments. Small spends clear immediately. Larger payouts sit behind review delays and stay cancellable.

* **Security delays** for large amounts
* **Cancel anytime** before payment
* **Transparent onchain** for both parties
* **No funds locked** until actual payment

*Example: Your agent buys a $3 dataset instantly. Larger payouts wait behind a review window.*

### [Whitelist: Instant Access for Trusted Addresses](/programmable-wallets/whitelist)

Unlimited access for your most trusted addresses.

* **No restrictions** for whitelisted addresses
* **Time-locked additions** for security
* **Instant removal** if ever needed

**Perfect for:** Multi-wallet strategies, hardware wallet, cold storage

> **Underscore lets agents execute with real money without ever giving them custody, private keys, or unrestricted access. Budgets, recipient rules, asset restrictions, review delays, and expiry windows are enforced onchain in open-source smart contracts.**

**→ Learn more:** [**Programmable Wallets**](/programmable-wallets/user-wallet)

***

## How It All Works Together

Your Underscore infrastructure isn't just one thing — it's an ecosystem of intelligent features working in harmony.

### An Agent's Day

**3 AM**: Your [yield agent](/programmable-wallets/managers) notices Morpho offering 1% better yield than Aave. It automatically rebalances $25k, staying within its $25,000 daily limit. You're asleep.

**6 AM**: Your trading agent's data feed subscription renews. $200 USDC pulls automatically from its [Payee](/programmable-wallets/payees) allowance. The agent keeps running.

**10 AM**: The trading agent needs a one-time dataset for backtesting. It creates a $3 [Digital Cheque](/programmable-wallets/cheques) — clears instantly, under the review threshold.

**2 PM**: A larger $5,000 compute job needs payment. The agent creates a cheque with a 3-day review window. You can cancel if something looks wrong.

**11 PM**: Your portfolio rebalanced 3 times today across 5 protocols. Your agent paid for its own services. You didn't lift a finger. No keys were shared.

### A Human's Day

**10 AM**: Monthly rent is due. Your landlord (configured as [Payee](/programmable-wallets/payees)) pulls exactly $2,500 USDC. Not a penny more. Your remaining funds keep earning yield.

**2 PM**: You need to pay a contractor. Create a $5,000 [cheque](/programmable-wallets/cheques) with 3-day delay. If they don't deliver, cancel it.

**4 PM**: Time to fund your trading wallet. Move $20k to your other Programmable Wallet ([whitelisted](/programmable-wallets/whitelist)) instantly.

***

## Who Uses Underscore

Underscore isn't a consumer app — it's infrastructure for agents, apps, and protocols. Think of it like AWS for DeFi — but fully non-custodial.

### Applications Building on Underscore

* **AI Agents & Autonomous Systems**: Yield optimization agents, trading bots, and autonomous economic actors operating as [Managers](/programmable-wallets/managers) within user-defined limits — paying for their own data feeds, compute, and inference APIs through [Payees](/programmable-wallets/payees) and [Cheques](/programmable-wallets/cheques)
* **Fintech Apps**: Like [Hightop](https://hightop.com), which uses Underscore to deliver digital banking for AI agents, made simple for humans — letting agents pay, get paid, keep cash productive, and move money while users stay in control
* **Vault Integrators**: Apps adding AI-managed yield without building infrastructure — integrate [Core Vaults](/earn-vaults/vaults) for passive yield or [Amplified Vaults](/earn-vaults/vaults) for a second yield layer
* **Payment Platforms**: Cross-border remittance, B2B payments, and payroll systems leveraging our [Cheques](/programmable-wallets/cheques) and [Payees](/programmable-wallets/payees)
* **Wallet Providers**: Adding advanced DeFi features and [programmable delegation](/programmable-wallets/managers) to existing wallets

### The Hightop Example

Hightop demonstrates the power of building on Underscore:

* **Digital banking for AI agents, made simple for humans**: Hightop gives users a clean product for agent money while Underscore provides the programmable control layer underneath
* **Let agents pay and get paid. You stay in control**: Hightop maps agent execution to [Managers](/programmable-wallets/managers), recurring counterparties to [Payees](/programmable-wallets/payees), one-off payouts to [Cheques](/programmable-wallets/cheques), and trusted exits to the [Whitelist](/programmable-wallets/whitelist)
* **Wallets, gas, and money movement stay behind the scenes**: Hightop abstracts [Programmable Wallets](/programmable-wallets/user-wallet) infrastructure, gas, and money movement while Underscore enforces limits, permissions, and payment rules onchain
* **Earn Autopilot and portfolio execution run on Underscore**: [Core Vaults](/earn-vaults/vaults), [Amplified Vaults](/earn-vaults/vaults), and Underscore Legos handle yield, swaps, and policy-aware asset execution across 25+ supported assets, while Ripe powers the lending layer and the leverage rails behind Amplified Vaults
* **x402-ready flows are live, and cards are coming soon**: Hightop already supports API-native inbound payments for agents and is extending the same control model to virtual cards

Most users will never interact with Underscore directly. They'll use apps like Hightop that leverage our infrastructure to deliver seamless experiences.

**→ Learn more:** [**Who Uses Underscore**](/getting-started/who-uses-underscore)

***

## Common Questions

**Is my wallet upgradeable?** No. Your wallet code is immutable for security. New features come through Lego integrations. If new features come, you can migrate to a new Programmable Wallet.

**What are Legos?** Standardized integrations with DeFi protocols. When new protocols launch, your wallet can use them immediately.

**Can I use multiple wallets?** Yes. Whitelist them for instant transfers between your wallets.

**What about L2s?** Currently Base L2 only. More chains coming.

**How do fees work?** Small fees on swaps (0.25%) and external reward claims (20%). Earn Vaults charge 20% performance fees on yield profits only. No fees on transfers, deposits, or idle funds. 100% of protocol revenue buys back [$RIPE](https://app.ripe.finance/ripe) in the open market. See [Protocol Economics](/economics/protocol-economics) for details.

**What happens if I lose my owner wallet?** If you've set up managers and whitelisted addresses beforehand, managers can still transfer funds to your whitelisted addresses (like hardware wallets), providing a recovery path.

**Can managers steal my funds?** No. Managers operate within blockchain-enforced limits. They can only perform authorized actions within your spending caps and cannot withdraw to external addresses or modify their own permissions.

**How do I handle emergency transfers?** Pre-whitelist your hardware wallet or secure addresses. Unlike payees (with limits) or cheques (with delays), whitelisted addresses can receive unlimited transfers instantly for emergencies.

***

## Payment Methods Comparison

Understanding which payment tool to use for different situations:

| Feature            | [**Whitelist**](/programmable-wallets/whitelist) | [**Payees**](/programmable-wallets/payees) | [**Cheques**](/programmable-wallets/cheques)  |
| ------------------ | ------------------------------------------------ | ------------------------------------------ | --------------------------------------------- |
| **Use Case**       | Instant unlimited transfers to trusted addresses | Automated recurring payments               | One-time payments with control                |
| **Payment Limits** | None — completely unlimited                      | Customizable per-recipient                 | Set per cheque                                |
| **Setup Time**     | Time-locked addition (configurable)              | Immediate with limits                      | No setup needed                               |
| **Key Benefit**    | Emergency access & multi-wallet strategies       | Set once, runs automatically               | Cancel anytime before cashed                  |
| **Best For**       | Hardware wallets, cold storage, other wallets    | Agent services, salaries, subscriptions    | Agent purchases, contractors, large transfers |
| **Risk Level**     | Highest — can drain wallet                       | Medium — capped by limits                  | Low — cancellable                             |

***

## Getting Started

### Quick Start

**Want passive yield? (2 minutes)**

1. Connect your wallet to Underscore
2. Choose a vault profile: Core Vaults for passive yield, or Amplified Vaults for yield amplification
3. Deposit — AI handles everything from here

**Building an AI agent? (10 minutes)**

1. Deploy a [Programmable Wallet](/programmable-wallets/user-wallet)
2. Add your agent as a [Manager](/programmable-wallets/managers) with permissions and budget
3. Configure [Payees](/programmable-wallets/payees) for recurring service costs (data feeds, compute, APIs)
4. Use [Digital Cheques](/programmable-wallets/cheques) for one-off payments

**Want full control? (5 minutes)**

1. Deploy your [Programmable Wallet](/programmable-wallets/user-wallet)
2. Add managers, payees, or whitelist addresses as needed
3. Start using 20+ DeFi protocols from one place

### Explore Features

**For Passive Yield**: Start with [Core Vaults](/earn-vaults/vaults) — deposit and let AI optimize. No wallet setup required.

**For Amplified Yield**: Explore [Amplified Vaults](/earn-vaults/vaults) to keep BTC or USDC exposure while adding a second yield layer through Ripe.

**For AI Agents**: Deploy a [Programmable Wallet](/programmable-wallets/user-wallet) and configure [Managers](/programmable-wallets/managers) for execution, [Payees](/programmable-wallets/payees) for recurring costs, and [Cheques](/programmable-wallets/cheques) for one-off spend.

**For Full Control**: Deploy a [Programmable Wallet](/programmable-wallets/user-wallet) and explore features that match your needs:

* **For Automation**: Set up [Managers](/programmable-wallets/managers) to delegate operations
* **For Recurring Payments**: Configure [Payees](/programmable-wallets/payees) for automated transfers
* **For One-Time Payments**: Use [Cheques](/programmable-wallets/cheques) with cancellation ability
* **For Multi-Wallet Strategies**: Add addresses to your [Whitelist](/programmable-wallets/whitelist)
* **For Earning Rewards**: Learn about [revenue sharing and bonuses](/economics/rewards)

***

## Technical Documentation

For developers and integrators: [Complete Technical Documentation](https://underscore-1.gitbook.io/developers/)

Build on Underscore's infrastructure with detailed guides on smart contract architecture, Lego Partner integrations, and security models. Over 30 production contracts documented with integration examples.

For live protocol parameters and contract deployments, use the [Params Explorer](https://params.underscore.finance).

***

## Community & Support

* **Discord**: [discord.gg/hightop](https://discord.gg/hightop)
* **Twitter/X**: [@underscore\_hq](https://x.com/underscore_hq)
* **GitHub**: [github.com/underscore-finance](https://github.com/underscore-finance/underscore-protocol)

***

## The Future of Financial Operations

AI agents need more than APIs — they need money. The ability to pay for services, capture yield, and move funds autonomously within safe boundaries.

Underscore delivers what crypto promised: programmable money that works as hard as you do. Your agents executing strategies within unbreakable boundaries. Your funds earning across protocols while maintaining liquidity for payments. Your security protecting without restricting.

Earn Vaults + Programmable Wallets. Your money never sleeps.


# Who Uses Underscore

Infrastructure for agents, apps, and protocols building with programmable payments and Earn Vaults

Underscore is infrastructure for agents, apps, and protocols. Some users experience it through products like Hightop, which uses Underscore to deliver digital banking for AI agents, made simple for humans. Others through AI systems operating inside Programmable Wallets. Most end users never know it's there.

Think of Underscore like AWS for DeFi — but fully non-custodial. Just as millions use Netflix without knowing about Amazon's servers, millions will use financial apps powered by Underscore's infrastructure. The key difference: users always maintain control of their funds. The complexity stays under the hood while users enjoy seamless experiences.

Underscore provides two core products: [**Earn Vaults**](/earn-vaults/vaults) for onchain yield that anyone can access, including Core Vaults and Amplified Vaults, and [**Programmable Wallets**](/programmable-wallets/user-wallet) with [Managers](/programmable-wallets/managers), [Payees](/programmable-wallets/payees), [Cheques](/programmable-wallets/cheques), and [Whitelist](/programmable-wallets/whitelist) — agentic wallets where AI agents and operators execute with real funds within onchain rules.

## Aligned Economics

* The protocol earns when users earn: most Underscore revenue comes from a 20% performance fee on vault profits only
* Small additional revenue comes from swap fees and external reward claim fees
* No fees on deposits, transfers, idle funds, or principal
* 100% of protocol revenue buys back [$RIPE](https://app.ripe.finance/ripe) in the open market
* See [Protocol Economics](/economics/protocol-economics) for details on fees, examples, and onchain verification

## The Underscore Ecosystem

### Who Builds on Underscore

**Fintech Applications**

* Consumer-facing apps that need DeFi yields
* Neobanks offering crypto services
* Payment processors requiring automated flows
* Apps integrating [Earn Vaults](/earn-vaults/vaults) for instant yield features, whether that means Core Vaults for passive yield or Amplified Vaults for a second yield layer

**Crypto Wallets**

* Wallets adding advanced DeFi features
* Wallet providers needing [programmable delegation](/programmable-wallets/managers)
* Multi-signature solutions requiring automation

**AI Agents & Autonomous Systems**

* **Yield Optimization Agents**: Operate as [Managers](/programmable-wallets/managers) within Programmable Wallets, rebalancing across Aave, Morpho, Euler, and Compound 24/7 within strict budget and protocol restrictions
* **Trading Agents**: Pay for market data feeds, inference APIs, and compute resources through [Payees](/programmable-wallets/payees) with fixed budgets — keeping their own infrastructure running autonomously
* **Autonomous Economic Actors**: Use [Digital Cheques](/programmable-wallets/cheques) for one-off purchases — datasets, temporary compute, analysis reports — with review delays on large purchases
* **Agent Orchestrators**: Platforms that deploy multiple agents, each with their own Manager permissions, budgets, and asset restrictions on a single Programmable Wallet

Underscore lets agents execute with real money without ever giving them custody, private keys, or unrestricted access. Budgets, recipient rules, asset restrictions, review delays, and expiry windows are enforced onchain.

**Enterprise Solutions**

* B2B payment platforms
* Corporate treasury management
* DAO financial operations
* Institutional DeFi access

### How End Users Experience Underscore

Users interact with friendly apps while Underscore handles the complexity:

* **Earning Yield**: "Deposit USDC, earn 8% APY" → [Core Vaults](/earn-vaults/vaults) route to optimal protocols automatically
* **Making Payments**: "Send $500 to contractor" → Underscore [cheque system](/programmable-wallets/cheques) ensures safety
* **Portfolio Management**: "AI optimizes my yield" → Underscore [manager](/programmable-wallets/managers) executes strategies
* **Asset Swaps**: "Trade ETH for USDC" → Underscore finds best rates across DEXs
* **Borrowing**: "Borrow against my ETH" → Underscore Ripe Protocol Lego manages collateral safely
* **Productive Collateral**: "Use my yield shares as collateral" → [Core Vault shares](/earn-vaults/vaults) work on Ripe while earning

The user sees a simple interface. Underscore does the heavy lifting.

## Case Study: Hightop

[Hightop](https://hightop.com) is digital banking for AI agents, made simple for humans. Let agents pay and get paid. You stay in control.

Hightop handles [Programmable Wallets](/programmable-wallets/user-wallet) infrastructure, gas, and money movement behind the scenes.

Under the hood, Underscore provides the money-control and execution layer for agent permissions, payments, withdrawals, Earn Autopilot, and portfolio execution. Hightop's Earn Autopilot uses both Core Vaults and Amplified Vaults, while borrowing and the leverage rails behind Amplified Vaults are powered by Ripe.

### What Hightop Offers Users

Through one product, Hightop users can:

* **Fund an account** and move money in and out through familiar rails
* **Set limits, permissions, and payment rules for each agent**
* **Let agents pay, get paid, earn, borrow, invest, and move money** without handing them private keys or unrestricted wallet access
* **Keep everything in a simple app** while [Programmable Wallets](/programmable-wallets/user-wallet) infrastructure, gas, and money movement stay behind the scenes and the control layer stays onchain and verifiable

### How Underscore Powers Each Feature

**Agent Control Layer**

* Hightop's agent control profiles map to Underscore [Managers](/programmable-wallets/managers)
* Wallet-wide and per-agent rules define what each agent can do, which assets and venues it can touch, who it can pay, how much it can spend, and when it expires
* Key boundaries are enforced onchain by immutable, open-source smart contracts, not just remembered by the app backend
* That trust model is transparent, onchain smart-contract infrastructure rather than opaque balance-sheet custody hidden behind an app

**Payments and Money Movement**

* Approved recurring counterparties map cleanly to Underscore [Payees](/programmable-wallets/payees)
* Ad hoc payouts and larger purchases use [Digital Cheques](/programmable-wallets/cheques) with optional review delays and cancellation windows
* Trusted withdrawal and self-custody paths use the [Whitelist](/programmable-wallets/whitelist) for instant transfers to approved destinations
* Agents can also get paid through one-off, usage-based, and x402-compatible flows over HTTP. A research agent can get paid per request, or a support agent can get paid per workflow
* This is how Hightop lets agents pay vendors, get paid, and move money without giving them open-ended account access

**Earn Autopilot**

* Hightop's Earn Autopilot uses Underscore's yield Legos plus both [Core Vaults](/earn-vaults/vaults) and [Amplified Vaults](/earn-vaults/vaults) to keep idle cash productive across multiple yield profiles
* Hightop's AI autopilot can maximize yield and help manage the portfolio without exposing users to protocol complexity

**Portfolio Execution**

* Swaps and portfolio moves run through Underscore's DEX integrations
* Agents can buy supported assets, rebalance portfolio targets, and execute approved strategies across venues like Aerodrome, Uniswap, and Curve
* Execution stays policy-aware, so agents can rebalance toward targets and rotate exposure without going off-script

**Cards (Coming Soon)**

* Hightop also highlights virtual cards as a coming-soon surface on top of the same control model
* Each agent can get its own virtual card, with spend rules enforced onchain and balances that can be auto-funded from Earn at the moment of purchase

**Borrowing**

* Hightop presents borrowing as a simple in-app feature
* The lending layer is powered by Ripe, which also supplies the leverage rails behind Amplified Vaults, while Underscore handles the surrounding agent controls, [Programmable Wallets](/programmable-wallets/user-wallet) permission model, and agent execution model

### The Hightop User Experience

From the user's perspective:

1. Download [Hightop](https://hightop.com) app
2. Fund the account through familiar bank or crypto rails
3. Create an agent and give it clear rules
4. Let that agent pay, get paid, earn, invest, or protect the portfolio inside its lane
5. Borrow when needed and withdraw to trusted destinations anytime

What they never see:

* Token approvals for 20+ protocols
* Yield protocol comparisons and cash routing logic
* Slippage calculations
* Smart contract interactions
* Agent permissions, payment-path rules, and spending guardrails
* Any concept of gas, private keys, or seed phrases

They just use a clean product while the money layer stays programmable. That's the power of building on Underscore.

## Case Study: AI Trading Agent

A trading agent needs to operate autonomously: rebalance positions, pay for data feeds, and buy occasional datasets — all without custody or private keys.

### How Underscore Powers the Agent

**Execution (**[**Manager**](/programmable-wallets/managers)**)**

* Agent is configured as a Manager on the wallet owner's Programmable Wallet
* Permissions: Buy & Sell, Manage Yield, General Transfers to approved Payees
* Limits: $25,000 daily, stablecoins only, approved protocols only
* Time controls: 6-hour cooldown, 90-day expiry with renewal

**Recurring Costs (**[**Payees**](/programmable-wallets/payees)**)**

* Data feed provider: $200/month pull payment
* Inference API: $1,000/month, 50 transactions max
* Compute vendor: $500/week

**One-Off Purchases (**[**Cheques**](/programmable-wallets/cheques)**)**

* Dataset purchases under $100: instant
* Larger purchases: 3-day review window, cancellable by owner

**What the agent never gets:**

* Private keys
* Ability to add new payment recipients
* Access to exceed its budget
* Permission to touch restricted assets

The agent executes with real money. The owner maintains full control. All boundaries enforced onchain.

## Perfect for Vault Integration

The fastest way to add AI-managed yield to any application:

### Why Integrate Vaults

Underscore Earn Vaults share one architecture but two return profiles: Core Vaults for straightforward AI-managed yield, and Amplified Vaults for a Ripe-powered second yield layer.

**For Fintech Apps**

Skip months of infrastructure development. Integrate [Core Vaults](/earn-vaults/vaults) directly, or build around [Amplified Vaults](/earn-vaults/vaults) when you want a second yield layer:

* Standard ERC4626 interface — minimal integration work
* AI optimization handled entirely by Underscore
* Users deposit through your interface, you track shares
* No wallet infrastructure needed on your side

**For DeFi Protocols**

Make collateral productive:

* Accept Core Vault shares as collateral
* Users earn yield while borrowing
* Standard ERC20 compatibility
* Vault value trackable on-chain

**For Portfolio Managers**

Offer managed strategies without building infrastructure:

* Core Vaults for straightforward yield optimization
* Amplified Vaults for amplified returns with managed risk
* White-label as your own product
* Focus on user acquisition, not infrastructure

### Example: Quick Vault Integration

A payment app wants yield on user float:

```
Traditional approach:
- Build yield infrastructure (3-6 months)
- Integrate multiple protocols (ongoing maintenance)
- Build rebalancing logic (security risk)
- Audit everything ($$$$)

Vault approach:
- Call deposit() with user funds
- Track user shares internally
- Call redeem() for withdrawals
- Done in 2 weeks
```

The vault handles protocol selection, rebalancing, reward claiming, and risk management. The app handles UX.

***

## Perfect for Payment Applications

Underscore's payment infrastructure makes it ideal for the next generation of payment apps:

### Cross-Border Remittance Apps

Transform international money transfers with:

* [**Cheques**](/programmable-wallets/cheques) for secure, cancellable transfers with built-in fraud protection
* [**Payees**](/programmable-wallets/payees) for recurring family remittances with spending limits
* **Instant settlement** through stablecoins while funds earn yield waiting for pickup
* **Pull payments** letting recipients withdraw when exchange rates are favorable

### B2B Global Payment Platforms

Revolutionize business payments with:

* **Automated invoicing** through [Payees](/programmable-wallets/payees) with net-30/60/90 terms
* **Escrow-like functionality** using [Cheques](/programmable-wallets/cheques) with approval workflows
* **Multi-currency treasuries** earning yield between payment cycles
* **Delegated payment approval** via [Managers](/programmable-wallets/managers) for finance teams

### Payroll & Expense Platforms

Modernize employee payments with:

* **Pull-based salaries** where employees withdraw their exact pay
* **Expense reimbursements** with automatic limits and approvals
* **Contractor payments** using cancellable [Cheques](/programmable-wallets/cheques)
* **Multi-level approval chains** through [Manager](/programmable-wallets/managers) permissions

### Why Underscore for Payments?

* **Programmable money**: Set exact rules for every payment relationship
* **Yield on float**: Funds earn DeFi yields until the second they're needed
* **Fraud prevention**: Time-locks, cancellations, and limits protect users
* **Global instant settlement**: No banking hours, no correspondent banks
* **Regulatory friendly**: Clear audit trails and permission systems

## Why Developers Choose Underscore

**Speed to Market**

* Ship DeFi features in weeks, not months
* One integration gives access to all the top DeFi protocols
* Pre-built delegation and payment systems
* Production-ready smart contracts from day one

**Risk Reduction**

* Battle-tested security patterns
* User funds protected by time-locks and permissions
* Clear audit trails for every transaction
* No infinite token approvals or honeypot risks

**Future-Proof**

* New protocols automatically available through Legos
* No re-integration when protocols update
* Built for multi-chain expansion
* Community-driven protocol additions

## The Future: Invisible Infrastructure

As Underscore grows, it becomes more invisible. Users won't ask "Does this use Underscore?" any more than they ask "Does this use HTTPS?" It will simply be the standard for:

* **Every fintech** offering DeFi yields
* **Every wallet** with advanced features
* **Every AI agent** managing portfolios and paying for its own services
* **Every platform** needing payment automation

The best infrastructure disappears into the background, enabling experiences that feel like magic.

***

## Join the Revolution

Ready to build on Underscore or learn more about the future of financial infrastructure?

### Connect With Us

* **Discord Community**: Join our developer discussions at [discord.gg/hightop](https://discord.gg/hightop)
* **Follow Updates**: Stay informed on Twitter/X [@underscore\_hq](https://x.com/underscore_hq)
* **GitHub**: Explore the code at [github.com/underscore-finance](https://github.com/underscore-finance/underscore-protocol)

Whether you're building the next billion-dollar fintech, optimizing payment flows, or creating AI-powered financial tools, our community is here to help.

***

Remember: the best infrastructure disappears into the background. Underscore handles the complexity so developers can build products where agents, apps, and operators move real money safely.


# DeFi Integrations

Complete list of DeFi protocols accessible through your Underscore wallet

Your Underscore wallet connects to 20+ DeFi protocols through standardized adapters called "Legos". Here's the complete list of what's available today.

## Yield & Lending Protocols

| Protocol          | Type       | What You Can Do                                 |
| ----------------- | ---------- | ----------------------------------------------- |
| **Aave V3**       | Lending    | Deposit for yield                               |
| **Morpho**        | Lending    | Isolated lending markets with competitive rates |
| **Compound V3**   | Lending    | Deposit for yield                               |
| **Euler**         | Lending    | Deposit for yield, isolated lending markets     |
| **Fluid**         | Lending    | Deposit for yield                               |
| **Moonwell**      | Lending    | Base-native lending protocol                    |
| **Ripe Protocol** | Stablecoin | Borrow GREEN/sGREEN against any collateral      |
| **Sky PSM**       | Stablecoin | MakerDAO's Peg Stability Module                 |
| **40 Acres**      | Yield      | Specialized yield strategies                    |
| **Wasabi**        | Yield      | Yield optimization                              |
| **Avantis**       | Yield      | Yield aggregation                               |
| **ExtraFi**       | Yield      | Additional yield sources                        |

## Decentralized Exchanges

| Protocol       | Type       | What You Can Do                              |
| -------------- | ---------- | -------------------------------------------- |
| **Aerodrome**  | DEX        | Swap, LP (Classic + Slipstream concentrated) |
| **Uniswap V2** | DEX        | Swap, simple liquidity provision             |
| **Uniswap V3** | DEX        | Swap, concentrated liquidity (NFT positions) |
| **Curve**      | Stableswap | Low-slippage stablecoin swaps, LP            |

## Automatic Protocol Access

Your wallet is future-proof. When new protocols are integrated:

* No migration needed
* No wallet updates required
* Automatically available through new Lego deployments
* All existing security settings still apply

**Live data**: See all active integrations and their onchain status in the [Params Explorer](https://params.underscore.finance/legos).

## Protocol Safety

All integrated protocols are:

* Established with significant TVL
* Audited by reputable security firms
* Battle-tested on mainnet

Underscore only integrates protocols that meet strict security standards.

## What Are Legos?

Legos are standardized adapters that give your wallet access to each protocol. They handle the complexity of interacting with different smart contracts behind a consistent interface.

**Benefits of the Lego architecture**:

* **Simplicity**: One interface for all protocols
* **Safety**: Audited adapters with built-in protections
* **Future-proof**: New protocols work automatically
* **Composability**: Combine operations across protocols in single transactions


# Earn Vaults: Core Vaults and Amplified Vaults

Earn Vaults combine Core Vaults for passive AI-managed yield with Amplified Vaults for Ripe-powered yield amplification

Underscore Earn Vaults share one architecture and two return profiles:

* **Core Vaults**: AI-managed passive yield wrapped into standard ERC-4626 shares
* **Amplified Vaults**: built on top of Core Vault shares, using Ripe Protocol to add a second yield layer while keeping the borrowed leg in USD-denominated strategies

Earn Vaults are non-custodial. Your assets stay yours. Withdraw anytime, no permissions required.

The key difference from a [Programmable Wallet](/programmable-wallets/user-wallet): your position isn't locked. Vault shares are composable tokens you can use anywhere in DeFi — trade them, use them as collateral, bridge them cross-chain. The underlying strategy keeps running no matter where your tokens go.

***

## Why Earn Vaults Exist

### The Origin Story

Vaults weren't designed in a vacuum — they emerged from real problems we hit while building.

We started with [Hightop](https://hightop.com), which uses Underscore to deliver digital banking for AI agents, made simple for humans. One of the first workflows there was Earn Autopilot: keep idle cash productive, monitor markets, and rebalance individual [Programmable Wallets](/programmable-wallets/user-wallet) toward better yield opportunities. It worked, but we quickly ran into a wall: every optimization meant touching every wallet. If we wanted to roll out the same improved strategy to 10,000 users, that was 10,000 separate transactions. Expensive. Slow. The agents were doing the same work over and over for users who wanted the same outcome.

Then came Ripe Protocol. Users would borrow against their yield-bearing positions — Aave deposits, Morpho positions, and the like. But once those positions became collateral, they were locked. Even if a better yield opportunity appeared, users couldn't rebalance that collateral without first repaying their loan. Their yield-earning assets were stuck.

Both problems came from the same place: real users, real usage, real feedback. We felt the inefficiency firsthand running Hightop's yield automation at scale across individual wallets.

So we built Earn Vaults. The core insight: keep everything we built with Programmable Wallets — the AI capabilities, the clear boundaries, the onchain rules and policies — but give the AI just one "wallet" to manage. Users deposit into a shared vault and receive tokens representing their share. The AI optimizes once, everyone benefits. And because Core Vault shares are standard tokens, they can be used as collateral on Ripe while the AI keeps optimizing the underlying positions.

This architecture also opened the door to new vault types: Amplified Vaults, index vaults, and more — all built on the same foundation.

Today, Earn Vaults are live, and both Core Vaults and Amplified Vaults already power Hightop's live Earn Autopilot experience.

### Scale

One vault, one rebalance, everyone benefits.

That's how we scale to millions of users.

### Composability

Core Vault shares are standard ERC-20 tokens. This unlocks:

* **Collateral**: Use Core Vault shares on Ripe Protocol to get a loan — the AI keeps optimizing your collateral even while it's locked
* **Liquidity**: Sell shares in liquidity pools for instant exit
* **Portability**: Bridge cross-chain, use in other protocols
* **Integration**: Any app can plug into Earn Vaults with a standard interface

Your position becomes a building block, not a locked asset.

### Simplicity

Chasing yields is exhausting. Checking Morpho rates, comparing Aave markets, tracking Euler promotions, claiming rewards before they expire — it's a full-time job.

Core Vaults handle all of it. Users deposit, get a token, and earn yield. All the complexity — multi-protocol strategies, AI rebalancing, risk management, claiming and compounding rewards — happens behind the scenes.

***

## How Core Vaults Work

Simple yield optimization for your assets.

### How It Works

1. **Deposit**: Deposit USDC, ETH, or other supported assets into the vault
2. **Receive Shares**: Get vault tokens (e.g., \_USDC) representing your share of the pool
3. **AI Optimizes**: The agent rebalances across approved protocols, vaults, and yield strategies
4. **Withdraw Anytime**: Redeem shares for underlying assets whenever you want

### What the AI Does

The AI agent continuously optimizes the vault's positions:

* **Continuous Monitoring**: Watches rates, liquidity, incentives, and withdrawal conditions across Morpho, Euler, Moonwell, Aave, Fluid, Compound, and other approved protocols
* **Risk-Adjusted Routing**: Evaluates strategies beyond raw APY — analyzing depositor count, total deposits, utilization ratios, and available liquidity before moving capital
* **Automatic Rebalancing**: Moves funds to capture better risk-adjusted yields as conditions change
* **Reward Harvesting**: Claims and compounds protocol incentives automatically

### Example: USDC Core Vault

**You deposit 10,000 USDC**:

* Vault has 1,000,000 USDC total at $1.00/share
* You receive 10,000 \_USDC tokens

**After 3 months**:

* AI executed dozens of rebalances — capturing rate opportunities, evaluating risk before moving, rotating through promotions, claiming rewards as they unlock
* Vault now holds 1,025,000 USDC (2.5% growth)
* Your 10,000 \_USDC now redeemable for 10,250 USDC
* No action required from you

***

## Capital Efficiency with Ripe Protocol

Core Vault shares become premium collateral on [Ripe Protocol](https://ripe.finance). This unlocks powerful capital efficiency:

1. **Deposit** into a Core Vault, receive \_USDC
2. **Use \_USDC as collateral** on Ripe to borrow stablecoins
3. **Your collateral keeps earning** — the AI optimizes yield in the background
4. **Borrow and deploy** those stablecoins elsewhere

Your collateral works 24/7. This isn't static collateral sitting idle — it's actively earning while you leverage it.

***

## Amplified Vaults

Higher yields through managed leverage built on Core Vault shares and Ripe Protocol — with built-in debt safety.

### How It Works

Amplified Vaults amplify your yield by borrowing against your collateral, but with a key safety feature: **borrowed funds always maintain USD-based exposure** to ensure the vault can always repay its debt. The borrowed amount is also deposited back into Ripe as additional collateral, giving you two layers of collateral backing your debt — your original asset plus the borrowed USD.

Here's the full flow:

1. **You deposit** a supported base asset into the Underscore Amplified Vault (currently cbBTC or USDC)
2. **Vault deposits** your asset into the corresponding Core Vault (AI optimizes yield)
3. **Vault uses** those yield-bearing shares as collateral on Ripe Protocol
4. **Vault borrows** GREEN (stablecoin) against that collateral
5. **Vault swaps** GREEN to USDC
6. **Vault deposits** USDC into the USDC Core Vault (more yield)
7. **Vault adds** those USDC Core Vault shares as additional collateral on Ripe

The result: your original asset earns yield, AND the borrowed amount earns yield — but the borrowed portion stays in USD-denominated assets.

#### Yield Math: Amplified cbBTC

Let's walk through the math with a $100,000 cbBTC deposit:

| Layer                      | Amount   | Rate | Annual Yield |
| -------------------------- | -------- | ---- | ------------ |
| cbBTC in Core Vault        | $100,000 | 0.5% | +$500        |
| Borrow from Ripe (70% LTV) | $70,000  | 3%\* | -$2,100      |
| USDC in Core Vault         | $70,000  | 8%   | +$5,600      |
| **Net Yield**              |          |      | **+$4,000**  |

*\*In this example, the 3% borrow rate reflects Ripe's protocol-level Underscore vault discount: a 50% discount applied to a standard 6% borrow rate. This discount is configurable and may change.*

**Combined APY: 4.0%** on your original $100k cbBTC — an 8x improvement over the base 0.5% yield, while maintaining full BTC exposure.

### Why USD-Based Debt Matters

This design protects the vault from liquidation:

* **Borrowed funds stay in USDC or Savings GREEN** — The vault cannot swap borrowed capital into BTC or other volatile assets
* **Debt is always covered** — Even if your BTC collateral (cbBTC) drops 50%, the borrowed USD portion maintains its value
* **No death spiral** — The borrowed amount doesn't amplify losses from price drops

**Example**: Using the same $100k cbBTC deposit from above:

* Vault borrows $70,000 in GREEN (70% LTV), swaps to USDC
* cbBTC drops 40% → Your original collateral is now worth $60,000
* But the $70,000 borrowed is still earning yield as USDC
* That USDC is also deposited as collateral on Ripe — so you have $60k + $70k = $130k total collateral against $70k debt
* Position remains healthy because borrowed funds didn't lose value AND they add to your collateral

Compare this to traditional leveraged positions where borrowed funds buy more of the volatile asset — those can cascade into liquidation.

### What the AI Does

The AI manages both yield and risk:

* **Collateral Management**: Deposits assets into Core Vaults, then into Ripe Protocol
* **Strategic Borrowing**: Borrows GREEN against collateral, then either swaps to USDC (if DEX liquidity is favorable) or stakes as Savings GREEN — either way, the borrowed amount earns yield
* **USD Exposure Only**: Borrowed funds stay in USD-denominated assets (USDC or GREEN) — never swapped to volatile assets
* **Debt Ratio Monitoring**: Maintains configurable maximum leverage
* **Automatic Deleveraging**: Reduces positions when debt ratios approach limits

### Risk Management

Amplified vaults include built-in safety mechanisms:

| Control                   | Purpose                                        |
| ------------------------- | ---------------------------------------------- |
| **USD-Only Borrowing**    | Borrowed funds maintain stablecoin exposure    |
| **Max Debt Ratio**        | Hard limit on leverage (e.g., 200% max)        |
| **Auto-Deleverage**       | Reduces positions as ratios approach limits    |
| **Withdrawal Safety**     | Automatically unwinds leverage for redemptions |
| **Continuous Monitoring** | AI watches health factor around the clock      |

### Example: Amplified cbBTC Vault

**You deposit 1 cbBTC ($100,000)**:

```
Your 1 cbBTC
    ↓
cbBTC Core Vault (earning 0.5%)
    ↓
Deposit Core Vault shares to Ripe as collateral
    ↓
Borrow $70,000 GREEN (70% LTV) → swap to USDC
    ↓
USDC Core Vault (earning 8%)
    ↓
Deposit USDC Core Vault shares to Ripe as additional collateral
```

**Yield amplification**:

* Your cbBTC earns 0.5% in the cbBTC Core Vault → +$500/year
* Borrow cost at 3% (discounted rate) → -$2,100/year
* Your borrowed $70k earns 8% in the USDC Core Vault → +$5,600/year
* **Net yield: 4.0%** — an 8x improvement over base yield

**If cbBTC drops 40%**:

* Your cbBTC collateral: now worth $60,000
* Your USDC collateral: still worth $70,000
* Total collateral: $130,000 against $70,000 debt
* Position remains healthy — no liquidation risk

**Your risk exposure**: Only the price movement of your original deposit (cbBTC). The leverage doesn't amplify your losses — it only amplifies your yield. If cbBTC drops 40%, you lose 40% of your initial value, same as holding cbBTC directly. The borrowed USD portion maintains its value and doesn't add downside risk.

***

## Core Vaults vs Amplified Vaults

| Feature                           | **Core Vaults**                                     | **Amplified Vaults**                                                    |
| --------------------------------- | --------------------------------------------------- | ----------------------------------------------------------------------- |
| **Return profile**                | Passive AI-managed yield                            | Core yield plus a second USD-based borrowed yield layer                 |
| **Borrowing inside the strategy** | No                                                  | Yes, via Ripe Protocol                                                  |
| **Debt exposure**                 | None                                                | Managed debt with auto-deleverage                                       |
| **Collateral usage**              | Optional: use shares on Ripe yourself               | Built into the vault strategy                                           |
| **Best For**                      | Passive earners who want composable ERC-4626 shares | Users who want BTC or USDC exposure with additional yield amplification |

***

## Deposits & Shares

### Making a Deposit

1. Approve the vault contract to spend your tokens
2. Call `deposit()` with your desired amount
3. Receive vault shares to your wallet

**Share Price Calculation**:

```
Share Price = Total Vault Assets / Total Shares Outstanding
```

For the first deposit, 1 share = 1 asset. As the vault earns yield, share price increases.

### Understanding Your Shares

Vault shares represent proportional ownership of everything in the vault:

* **100 shares at $1.00** = $100 claim on vault assets
* **Vault earns 10% yield** = Share price rises to $1.10
* **Your 100 shares now worth $110** = You captured the yield

You don't need to claim rewards or rebalance. Your shares automatically reflect the vault's performance.

### Withdrawing

Redeem shares for underlying assets anytime:

1. Call `redeem()` or `withdraw()` with your share amount
2. AI automatically unwinds positions as needed
3. Receive underlying assets to your wallet

A small buffer (2%) ensures you receive your expected amount even during position unwinding.

***

## Vault Safety & Controls

### Approved Protocols Only

Each vault operates within strict boundaries — enforced by smart contracts, not company policies:

* **Whitelisted Destinations**: AI can only deposit to pre-approved yield protocols
* **Registry Controlled**: Underscore governance manages the approved protocol list
* **No Rogue Deposits**: The AI literally cannot move funds to unapproved destinations — it's not a matter of trust, it's code

These rules are onchain. No rogue trades. No experimental farms. No hallucinations.

### Deposit Controls

Earn Vaults can implement additional safeguards:

| Control            | Purpose                                       |
| ------------------ | --------------------------------------------- |
| **Deposit Caps**   | Maximum total assets to prevent concentration |
| **Allowlist Mode** | Restrict deposits to approved addresses only  |
| **Pause Deposits** | Temporarily stop new deposits if needed       |

### Emergency Controls

For extreme market conditions:

* **Freeze Operations**: Governance can halt all vault activity
* **Pause Withdrawals**: Temporary hold during market stress (governance only)
* **Protected Funds**: Even frozen, your share claim remains valid

***

## Performance Fees

Earn Vaults charge fees only on profits — never on your principal:

* **Rate**: 20% of yield generated
* **Applied To**: Profits only, not deposits
* **Transparent Tracking**: Fees tracked separately from share mechanics
* **No Surprise Deductions**: Your withdrawal reflects actual asset value

**Example**:

* Vault earns $1,000 in yield
* 20% fee = $200 to protocol
* $800 distributed to depositors via increased share price

Most Underscore revenue comes from this 20% performance fee on vault profits. The protocol earns when vault users earn. 100% of fee revenue buys back [$RIPE](https://app.ripe.finance/ripe) in the open market.

See [Protocol Economics](/economics/protocol-economics) for how fees are used.

***

## Core Vaults vs Programmable Wallets

| Feature               | **Core Vaults**              | **Programmable Wallets**       |
| --------------------- | ---------------------------- | ------------------------------ |
| **Ownership**         | Proportional shares (tokens) | Full control of assets         |
| **Management**        | AI-managed, hands-off        | You + your managers decide     |
| **Customization**     | Fixed strategy per vault     | Fully customizable             |
| **Composability**     | High (standard ERC-20)       | Lower (assets in wallet)       |
| **Access**            | Anyone can deposit           | Requires wallet deployment     |
| **Use as Collateral** | Yes (shares are tokens)      | More complex                   |
| **Best For**          | Passive yield, composability | Active DeFi, custom strategies |

**Use Core Vaults When**: You want set-and-forget yield, need composable/productive collateral, or want to participate without wallet setup.

**Use Programmable Wallets When**: You want full control, custom strategies, agent execution, payment automation, or manager delegation with precise limits.

***

## Real-World Examples

### Passive Yield Seeker

**Sarah** has 50,000 USDC sitting idle. She wants yield but doesn't have time to monitor rates.

**Solution**: Deposits to the USDC Core Vault

* Receives \_USDC tokens instantly
* AI captures yields across Morpho, Aave, Euler, and more.
* Uses \_USDC as collateral on Ripe to borrow for other opportunities
* Her collateral earns yield while borrowed against

**Result**: Productive yield + productive collateral, zero management required.

### Fintech App Integration

**PayFlow** is a payment app wanting to offer yield on user balances.

**Problem**: Building yield infrastructure from scratch requires significant engineering effort and security audits.

**Solution**: Integrates Underscore Core Vaults directly

* Users deposit through PayFlow's interface
* Vault handles all yield optimization
* PayFlow tracks user shares internally
* Standard ERC4626 interface, minimal integration work

**Result**: AI-managed yield without building yield infrastructure.

### Amplified Yield Strategy

**Marcus** wants amplified yield on his BTC without managing liquidation risk.

**Solution**: Deposits 1 cbBTC to the Amplified cbBTC Vault

* cbBTC earns base yield in the cbBTC Core Vault
* Vault borrows USDC against his cbBTC-linked collateral (70% LTV) via Ripe Protocol
* Borrowed USDC earns yield in the USDC Core Vault
* Borrowed funds stay USD-denominated — no amplified downside if BTC drops
* AI manages rebalancing and debt ratios automatically

**Result**: \~8x yield improvement over base BTC yield, with risk exposure limited to BTC price movement only.

***

## Common Questions

**Can I withdraw anytime?** Yes. Withdrawals are immediate — the vault automatically unwinds positions as needed to fulfill your request in a single transaction.

**What if the vault loses money?** Your shares reflect actual vault value. If underlying assets lose value (market movement, not AI error), share price decreases. Performance fees only apply to profits.

**What assets can I deposit?** Core Vaults specify their underlying asset (USDC, ETH, cbBTC, AERO, RIPE, etc.). Amplified Vaults currently support BTC- and USDC-based positions on Base.

**Are vault shares transferable?** Yes. Vault shares are standard ERC-20 tokens. Transfer, trade, or use as collateral anywhere ERC-20 tokens are accepted.

**What's the minimum deposit?** No protocol-enforced minimum, though gas costs make very small deposits impractical.

***

## Get Started

Ready to earn AI-optimized yield? [**Open the app →**](https://app.underscore.finance/)

* **Deposit directly**: Connect your wallet and deposit into a Core Vault or Amplified Vault
* **Choose your profile**: Use Core Vaults for passive yield or Amplified Vaults for a Ripe-powered second yield layer
* **Track your position**: Your vault shares appear in any ERC-20 compatible wallet
* **Use as collateral**: Deposit shares to Ripe Protocol to borrow against your yield
* **Withdraw anytime**: Redeem shares for underlying assets whenever you need them
* **Build on vaults**: Integrate into your app via [technical documentation](https://underscore-1.gitbook.io/developers)
* **Inspect live vault configs**: View current vault parameters and addresses in the [Params Explorer](https://params.underscore.finance/vaults)

For full control over your DeFi strategy, explore [Programmable Wallets](/programmable-wallets/user-wallet) with custom managers, payment automation, and more.

***

*Deposit. Earn. Amplify. Compose.*


# Programmable Wallets

Agentic wallets with programmable payments and DeFi access — execution rights without custody

Most agents can recommend. Underscore lets them execute with real funds without ever holding your private keys.

Underscore Programmable Wallets are smart contract wallets purpose-built for AI agents and operators to execute within onchain rules. [Managers](/programmable-wallets/managers) define permissions. [Payees](/programmable-wallets/payees) handle recurring spend. [Digital Cheques](/programmable-wallets/cheques) handle one-off payments with optional review delays. Everything is enforced onchain in open-source smart contracts.

Unify access to 20+ DeFi protocols through a single address. Delegate operations to agents within strict boundaries. Automate payments while funds earn yield. Move capital between your wallets instantly.

Built on Base L2, your wallet combines institutional-grade security with the flexibility to capture opportunities 24/7 — whether agents are executing autonomously or you're managing directly.

At its core, Underscore Programmable Wallets provide four key components:

1. **Unified Protocol Access**: Direct integration with top DeFi protocols through standardized adapters
2. **Agent Execution**: [Managers](/programmable-wallets/managers) who execute strategies within defined boundaries — no custody, no keys
3. **Payment Rails**: Programmable payment systems for recurring spend and one-off approvals (see [Payees](/programmable-wallets/payees) and [Cheques](/programmable-wallets/cheques))
4. **Security Layers**: Time-locks, whitelists, and granular permissions protecting every operation

## One Wallet, Every Protocol

Underscore connects to DeFi protocols through standardized adapters called "Legos". Each Lego provides a consistent interface for protocol-specific operations, enabling atomic multi-protocol transactions with optimized gas usage.

**Your wallet is future-proof**: When new DeFi protocols launch or existing ones add features, they're automatically available to your wallet through new Lego integrations. No need to migrate funds, deploy a new wallet, or update anything — your existing Programmable Wallet instantly gains access to every new protocol the moment its Lego is deployed.

### Yield & Lending Protocols

**Integrated protocols**: Morpho, Moonwell, Aave, Euler, Fluid, Compound, plus specialized protocols like Avantis, ExtraFi, and more

**Capabilities**:

* Deposit assets to earn yield
* Withdraw funds with automatic unwinding
* Track yields and calculate profits
* Claim protocol rewards
* Rebalance between protocols

### Trading & DEX Integration

**Integrated DEXs**: Aerodrome, Uniswap, Curve

**Capabilities**:

* Swap tokens with smart routing (up to 5 hops)
* Add/remove liquidity with automatic ratio calculation
* Support for both standard (uni v2) and concentrated liquidity (uni v3+)
* Manage NFT positions and adjust ranges

### Debt Management

**Integrated protocol**: [Ripe Protocol](https://ripe.finance)

Ripe Protocol is Underscore's borrowing partner, letting you access liquidity without selling your assets. The key advantage: **Underscore Core Vault shares are accepted as collateral**. This means your assets can be earning AI-optimized yield while you borrow against them — you're not choosing between yield and liquidity, you get both. Amplified Vaults build on that same pattern inside the vault strategy.

**How It Works**:

1. **Deposit Collateral**: Lock assets in Ripe Protocol — including Underscore Core Vault shares
2. **Borrow Against It**: Take a loan in GREEN (stablecoin) or yield-bearing sGREEN
3. **Keep Earning**: If using Core Vault shares as collateral, your underlying assets continue earning optimized yield
4. **Repay Anytime**: Pay back principal + interest on your schedule
5. **Reclaim Collateral**: Withdraw your assets once debt is cleared

**Why This Matters**:

Traditional borrowing forces a choice: either earn yield OR use assets as collateral. With Underscore + Ripe:

* Deposit into a Core Vault (AI optimizes your yield)
* Use your Core Vault shares as collateral on Ripe
* Borrow GREEN/sGREEN for liquidity needs
* Your collateral keeps earning the whole time

**Capabilities**:

* Deposit any supported asset as collateral
* Use Underscore Core Vault shares as productive collateral
* Borrow GREEN (stablecoin) or sGREEN (yield-bearing stablecoin)
* Repay debt with any accepted token
* Earn and claim RIPE rewards on debt positions

**Manager Permissions**:

* **Manage Debt**: Add/remove collateral, borrow, repay
* Managers cannot withdraw borrowed funds to external addresses
* All operations respect standard manager limits

**Why Borrow?**

* Access liquidity without selling appreciating assets
* Keep earning yield on your collateral
* Tax efficiency — loans aren't taxable events
* Bridge short-term cash flow needs

### Asset Transformations

**Capabilities**:

* ETH ↔ WETH conversion with zero slippage
* Mint and redeem receipt tokens (like stETH)
* Handle delayed redemptions
* Automatic format conversion for protocol requirements

### Rewards & Incentives

**Capabilities**:

* Batch claim rewards across all protocols in one transaction
* Auto-compound rewards into productive positions
* Track lifetime earnings across protocols

## Batch Operations: Multiple Actions, One Transaction

Underscore's architecture allows complex multi-step operations to execute atomically in a single transaction. This provides significant gas savings and eliminates the risk of partial execution.

### Examples of Batch Operations

**Yield Rebalancing**:

```
1. Withdraw from Aave (lower yield)
2. Deposit to Morpho (higher yield)
3. Claim rewards from both protocols
4. Convert rewards to productive assets
→ All in one transaction
```

**Complex Position Entry**:

```
1. Deposit collateral to Ripe Protocol
2. Borrow against collateral
3. Provide borrowed funds as liquidity
4. Stake LP tokens for additional yield
→ Complete strategy in one click
```

**Portfolio Rebalancing**:

```
1. Remove liquidity from multiple pools
2. Swap assets to target allocations
3. Re-deploy into new positions
4. Claim and reinvest all [rewards](rewards.md)
→ Entire rebalance atomically
```

## Swaps: Trade Any Token

When you swap tokens through your Programmable Wallet, the system finds the best route across integrated DEXes.

### How Swaps Work

Multi-hop routing example:

```
Want to swap USDC → PEPE?
Direct route may not exist or have poor liquidity.

Smart routing finds:
USDC → ETH → PEPE (2 hops)
or
USDC → WETH → PEPE (2 hops with better rate)

Up to 5 hops supported for optimal pricing.
```

### Slippage Protection

Every swap includes slippage protection — you specify the minimum amount you'll accept. If market conditions change and you'd receive less, the transaction reverts.

* Wallet default: Configurable per swap
* Manager limit: Managers have maximum slippage caps (e.g., 1% max)
* Fail-safe: Transactions revert rather than execute at bad prices

### Swap Fees

Underscore charges 0.25% on swaps. This is in addition to any DEX fees (which go to liquidity providers).

Swap fees are one of Underscore's smaller revenue sources. Like all protocol revenue, they are used to buy back [$RIPE](https://app.ripe.finance/ripe) in the open market.

### Manager Swap Controls

When managers execute swaps, additional controls apply:

* Maximum slippage percentage
* Maximum swaps per period
* Minimum USD value per swap
* Asset restrictions (which tokens can be swapped)

***

## Liquidity Provision: Earn From Trading Fees

Your Programmable Wallet lets you provide liquidity to decentralized exchanges and earn a share of trading fees. This is one of the most powerful DeFi strategies — your assets work for you by facilitating trades for others.

### How It Works

When you provide liquidity, you deposit a pair of tokens (like USDC and ETH) into a trading pool. Traders swap between these tokens and pay fees, which you earn proportionally to your share of the pool.

**Basic Example**:

```
You deposit: $5,000 USDC + $5,000 ETH worth
Pool share: 1% of total liquidity
Daily trading volume: $1,000,000
Fee rate: 0.3%
Your daily earnings: $30 (0.3% × $1M × 1%)
```

### Two Types of Liquidity

**Simple Liquidity (Uniswap V2 style)**

* Deposit equal value of two tokens
* Earn fees across all price ranges
* Receive LP tokens representing your share
* Supported on: Aerodrome Classic, Uniswap V2, Curve

**Concentrated Liquidity (Uniswap V3 style)**

* Choose specific price ranges for your liquidity
* Higher fees when price is in your range
* More capital efficient but requires monitoring
* Receive an NFT position (not fungible tokens)
* Supported on: Aerodrome Slipstream, Uniswap V3

### Manager Permissions for LP

Managers can handle liquidity operations with the **Manage Liquidity** permission:

* Add liquidity to approved pools
* Remove liquidity when rebalancing
* Subject to all standard manager limits

### Risks to Understand

**Impermanent Loss**: If token prices diverge significantly, you may have less value than if you held the tokens separately. This loss only becomes "permanent" when you withdraw.

**Smart Contract Risk**: LP positions exist within DEX smart contracts. Underscore integrates only with established, audited protocols.

***

## Other Wallet Features

### Eject Mode: Emergency Lockdown

If you suspect your wallet is compromised or need to restrict activity immediately, activate eject mode to lock down operations:

**When Active**:

* Only transfers and ETH/WETH conversions allowed
* No yield, swap, debt, or liquidity operations permitted
* Only wallet owner can perform any actions
* All managers are blocked from operating

**Use Case**:

```
Suspicious activity detected
    ↓
Activate eject mode (one transaction)
    ↓
Wallet locked to basic operations only
    ↓
Safely transfer funds to whitelisted addresses
    ↓
Deactivate eject mode when secure
```

Eject mode provides a panic button for emergencies — restrict first, investigate later.

### [Managers](/programmable-wallets/managers): Give Agents Execution Rights, Not Custody

Managers are authorized operators — human or AI — who execute actions within your defined boundaries. They can trade, optimize yields, and manage payments, but cannot withdraw to external addresses or exceed your limits.

**Use cases**:

* 24/7 yield optimization by AI agents
* Trading agents paying for data feeds, compute, and inference APIs
* Automated debt position management
* CFO handling vendor and contractor payments
* Professional traders managing portions of portfolio
* Family members with emergency access

[→ Learn more about Managers](/programmable-wallets/managers)

### [Payees](/programmable-wallets/payees): Let Agents Pay for the Services They Need

Payees are your recurring spend layer — pre-approved recipients that can receive only what you've authorized. Use them for market data feeds, model providers, compute vendors, contractors, payroll, and subscriptions. Your funds earn yield until payment time, then transfer automatically.

**Use cases**:

* Agent data feed and inference API subscriptions
* Compute vendor payments with weekly budgets
* Employee salaries paid from yield-earning funds
* Automated vendor and contractor payments
* Subscription services with pull payment capability

[→ Learn more about Payees](/programmable-wallets/payees)

### [Cheques](/programmable-wallets/cheques): One-Off Spend Without Blind Trust

Digital cheques turn transfers into controlled payment commitments. Small spends clear immediately. Larger payouts sit behind review delays and stay cancellable. Your funds keep earning yield until payment.

**Use cases**:

* Agent buying a one-time dataset or compute job
* Contractor payments you can cancel if work isn't delivered
* Large transfers with built-in review time
* One-time vendor invoices with payment flexibility
* Any payment where you need an "undo" option

[→ Learn more about Cheques](/programmable-wallets/cheques)

### [Whitelist](/programmable-wallets/whitelist): Unlimited Trust

The whitelist breaks the emergency glass on your security — addresses that get unlimited transfers with no delays or limits. Time-locked additions protect against compromise, while instant removal maintains control.

**Use cases**:

* Hardware wallet for emergency fund access
* Corporate treasury requiring immediate consolidation
* Multi-wallet strategies for risk distribution
* Gnosis Safe for recovery if you lose access

[→ Learn more about Whitelist](/programmable-wallets/whitelist)

## Architecture Comparison

| Traditional Multi-Wallet Setup      | Underscore Programmable Wallet |
| ----------------------------------- | ------------------------------ |
| Multiple interfaces and logins      | Single unified interface       |
| Manual token approvals per protocol | Pre-configured protocol access |
| External transfers between wallets  | Internal routing, no transfers |
| Manual yield tracking               | Automatic profit calculation   |
| Limited automation options          | Full delegation capabilities   |
| Separate security per wallet        | Unified security model         |

## Frequently Asked Questions

### 🔐 **Security & Control**

**Is this a self-custody wallet?**\
Yes. You keep custody of the owner keys and ultimate control of the assets. Managers can execute only the bounded actions you authorize onchain; they never receive custody or open-ended signing authority.

**What happens if Underscore disappears?** Your funds remain safe and accessible. The smart contracts are immutable and don't depend on Underscore's servers. You could interact with your wallet directly through BaseScan or any other interface. Current deployments and protocol configuration are also available in the [Params Explorer](https://params.underscore.finance/deployments).

**Can I migrate to a new wallet?** Yes. The protocol includes a migration system that lets you move funds and copy your configuration (managers, payees, whitelist) to a new Programmable Wallet. Useful if you want access to new features or need to restructure your setup.

### 💰 **Costs & Fees**

**What are the fees?**

* **Earn Vault performance fees**: 20% on yield profits only
* **Swap fees**: 0.25% on token swaps
* **External reward claims**: 20% when claiming protocol rewards (MORPHO, WELL, etc.)
* **Revenue use**: 100% of protocol revenue is used to buy back [$RIPE](https://app.ripe.finance/ripe) in the open market
* **No fees on**: Transfers, idle funds, deposits, debt operations, liquidity provision, or ETH/WETH wrapping

See [Protocol Economics](/economics/protocol-economics) for details on how fees work and where they go.

### Technical Setup

**Can I use this with my existing wallet?**\
Yes. You deploy your Underscore Programmable Wallet using your existing wallet (like MetaMask), which then acts as the owner key.

**What protocols can I access?**\
20+ protocols including Aave, Morpho, Compound (lending), Ripe Protocol (borrowing), Uniswap, Curve, Aerodrome (trading), and more. New protocols integrate automatically through the Lego system.

**What if Base L2 has issues?**\
Base inherits Ethereum's security model. In the unlikely event of L2 issues, established procedures exist for withdrawing assets to Ethereum mainnet. Your funds remain under your control.

***

## Your Move

AI agents need more than APIs. They need bounded onchain execution, programmable payment rails, and hard security limits.

Deploy a Programmable Wallet when you need agents or operators to rebalance, pay, borrow, repay, and move funds inside rules you control.

***

*Programmable Wallets + Earn Vaults. Your money never sleeps.*


# Managers

Give agents execution rights, not custody — within unbreakable boundaries you control

Most agents can recommend. Underscore lets them execute — with real funds, without ever holding your private keys.

Managers are authorized operators that execute strategies and handle payments for your [Programmable Wallet](/programmable-wallets/user-wallet) — without ever having full control. Set exact permissions: "Trade up to $50k USDC but never touch my ETH." Restrict to specific protocols: "Only rebalance between Aave, Morpho, Euler, and Compound." Define spending limits: "$10k daily, $100k monthly." Add time-based controls that auto-expire. Revoke access instantly with one click.

Let AI agents capture yield spikes at 3am. Let trading agents pay for their own data feeds and compute. Enable your CFO to pay vendor invoices without accessing reserves. Allow traders to work specific positions within exact boundaries. Every action validated onchain against your rules.

## Why Managers Exist

### The Agent Problem

AI agents need to execute transactions with real money — rebalancing yield positions, paying for data feeds, buying compute resources. But giving agents private keys or unrestricted access creates unacceptable risk. Traditional API keys and wallet delegation have no onchain enforcement. One bug, one exploit, and everything is gone.

Managers solve this by giving agents execution rights within smart-contract-enforced boundaries. The agent can do exactly what you authorize — nothing more, nothing less. Budgets, asset restrictions, protocol limits, and expiry windows are enforced by code, not policy.

### The Problem with Manual Wallet Management

Running a [Programmable Wallet](/programmable-wallets/user-wallet) solo creates impossible tradeoffs:

* **24/7 Opportunities**: DeFi never sleeps, but you do
* **Routine Tasks**: Paying vendors, [claiming rewards](/economics/rewards), rebalancing — repetitive time drains
* **Specialized Knowledge**: Complex strategies require expertise you might not have
* **Emergency Access**: If something happens to you, your funds are locked

Traditional solutions all fail:

* **Shared keys**: One compromised key loses everything
* **Multi-sig**: Slow, requires coordination for every transaction
* **Custody services**: You lose control and pay high fees

### The Manager Solution

Managers enable programmable delegation with precise controls:

* **Limited Permissions**: Grant only specific actions (lend, swap tokens, pay [Payees](/programmable-wallets/payees), etc.)
* **Spending Limits**: Hard caps on transaction and period amounts
* **Asset Restrictions**: Limit which tokens managers can touch
* **Instant Revocation**: Remove access with one transaction
* **Time Delays**: Optional cooling periods for sensitive actions

### Two-Phase Security Checks

Every manager action undergoes automatic validation:

**Before Any Action**:

* ✓ Is this manager still active?
* ✓ Can they perform this specific action?
* ✓ Can they touch this particular asset?
* ✓ Are they using an approved protocol?
* ✓ Has enough time passed since their last action?

**After The Action**:

* ✓ Did they stay under their per-transaction limit?
* ✓ Are they still within their daily/weekly/monthly budget?
* ✓ Have they exceeded their total lifetime allowance?

Both phases execute atomically within the transaction — if any check fails, the entire action reverts.

## Permissions: What Managers Can Do

Permissions are granular capabilities you grant to managers. You can mix and match these permissions to create the exact operator profile needed — from a CFO who only pays vendors to an AI that manages your entire DeFi strategy. Each permission is independent and can be combined with others.

### Transfer & Payment Operations

| Permission                                              | Capability                                                                                                                                           | Example Use Case        |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| **General Transfers**                                   | Send assets to [Payees](/programmable-wallets/payees), [Whitelist](/programmable-wallets/whitelist), or via [Cheques](/programmable-wallets/cheques) | Pay monthly expenses    |
| **Create** [**Cheques**](/programmable-wallets/cheques) | Schedule one-time payments                                                                                                                           | Delayed vendor payments |
| **Propose** [**Payees**](/programmable-wallets/payees)  | Add recurring payment recipients                                                                                                                     | Onboard new contractors |

### DeFi Operations

| Permission           | Capability                            | Example Use Case                                           |
| -------------------- | ------------------------------------- | ---------------------------------------------------------- |
| **Buy & Sell**       | Swap tokens, rebalance portfolios     | Maintain 60/40 ETH/USDC ratio                              |
| **Manage Yield**     | Deposit/withdraw from yield protocols | Rebalance Morpho/Aave positions                            |
| **Manage Debt**      | Handle loans and collateral           | Keep 150% collateralization                                |
| **Manage Liquidity** | Provide/remove DEX liquidity          | Optimize Uniswap V3 ranges                                 |
| **Claim Rewards**    | Harvest protocol incentives           | Collect and reinvest [farming rewards](/economics/rewards) |

### Administrative Operations

| Permission                 | Capability                    | Example Use Case                                  |
| -------------------------- | ----------------------------- | ------------------------------------------------- |
| **Whitelist Management**   | Add/remove approved addresses | Maintain vendor list                              |
| **Claim Protocol Rewards** | Harvest Underscore incentives | Auto-claim [platform rewards](/economics/rewards) |
| **Claim Loot**             | Collect revenue share         | Maximize [protocol earnings](/economics/rewards)  |

> **📝 Time Units in Underscore**\
> All time-based settings (delays, cooldowns, periods) are stored in blocks, not wall-clock time. On Base L2 with 2-second blocks:
>
> * 1 hour (1,800 blocks)
> * 1 day (43,200 blocks)
> * 1 week (302,400 blocks)
>
> Examples in this guide assume Base's 2-second block time.

## Controls: Security Boundaries

While permissions define what actions managers can take, controls set the boundaries within which they operate. These limits ensure that even trusted managers can't exceed your risk tolerance or drain your wallet through mistakes or malicious behavior. Every manager action must pass through these security checkpoints.

### Financial Limits

**Per-Transaction Limits**

* Maximum USD value for any single transaction
* Example: $5,000 cap prevents large one-time losses

**Period-Based Limits**

* Total USD value allowed within recurring time windows
* Period length set via `managerPeriod` in global settings (e.g., 1 day = 43,200 blocks)
* Periods reset automatically when the current period ends
* Example: $10,000 per day for trading operations

```
Week 1: Use $7k of $10k limit → Week 2: Fresh $10k limit
Unused amounts don't roll over — each period starts clean
```

**Lifetime Limits**

* Cumulative USD cap over Manager's entire tenure
* Example: $500,000 total for year-long AI service

### Operational Controls

**Transaction Cooldown**

* Mandatory waiting period between transactions
* Measured in blocks (e.g., 1 hour = 1,800 blocks on Base)
* Prevents rapid-fire mistakes or attacks

**Asset Restrictions**

* Limit Manager to specific tokens (e.g., only stablecoins)
* Granular control over what can be touched
* Maximum 40 different assets per manager

**Protocol Restrictions (Legos)**

* Restrict to specific DeFi protocols by ID
* Each protocol (["Lego"](/programmable-wallets/user-wallet#one-wallet-every-protocol) = standardized integration, e.g., Aave, Curve) registered in LegoBook
* Example: Only allow Aave and Compound interactions
* Maximum 25 different protocols per manager

**Approved Yield Protocols Only**

* Restrict managers to pre-approved vault tokens for yield deposits
* Prevents deposits into risky, unvetted, or unknown protocols
* Managed through the protocol's VaultRegistry whitelist
* Enable via `onlyApprovedYieldOpps` setting

**Payee Restrictions**

* Limit transfers to pre-approved addresses only
* Perfect for business operations with known vendors
* Maximum 40 approved [payees](/programmable-wallets/payees) per manager

**Fail on Zero Price**

* Safety feature blocking transactions when asset price is $0
* Prevents trading during oracle failures
* Protects against manipulation when prices unavailable

### Swap Controls

Control trading activity with dedicated swap permissions that protect against excessive losses and manipulation:

| Setting                  | Purpose                                    | Example                          |
| ------------------------ | ------------------------------------------ | -------------------------------- |
| **Max Slippage**         | Maximum acceptable price movement on swaps | Default: 5% max                  |
| **Max Swaps Per Period** | Limit trading frequency                    | Default: 2 swaps per day         |
| **Require USD Value**    | Both tokens must have price data           | Prevents trading unpriced tokens |

**How Slippage Protection Works**:

Before each swap, the system calculates the minimum acceptable output based on your slippage setting. If the actual output would fall below this threshold, the transaction reverts automatically.

```
Example: Swapping $1,000 USDC → ETH with 5% max slippage
Minimum acceptable: $950 worth of ETH
If DEX would return only $940 worth → Transaction reverts
```

This protects against:

* MEV sandwich attacks
* Price manipulation during execution
* Extreme market volatility
* Accidental bad trades

The system uses the tighter (lower) limit between global and manager-specific settings.

### Time-Based Security

**Activation Delay**

* New Managers wait before permissions activate
* Configurable delay period set by you (e.g., 1 hour, 1 day, 1 week)
* Time to verify additions and cancel if suspicious
* Protects against rushed or malicious manager additions

**Activation Length**

* Set Manager expiration periods
* Auto-revoke after: 30 days (trial), 90 days (quarterly), 365 days (annual)
* No action needed — permissions end automatically

### Global vs Specific Settings

Underscore employs a dual-layer configuration system where the most restrictive settings always apply:

**Global Manager Settings**

* Master template for all managers in your wallet
* Sets maximum boundaries no manager can exceed
* Includes `canOwnerManage` flag determining if you're subject to limits

**Specific Manager Settings**

* Individual configuration per manager
* Can be more restrictive than global, never less
* Both global AND specific permissions must allow an action

```
Example: Permission Hierarchy
Global: Can trade = Yes, Max per tx = $100k
Manager A: Can trade = Yes, Max per tx = $50k → Limited to $50k
Manager B: Can trade = No, Max per tx = $200k → Cannot trade at all
```

## Real-World Examples

### Yield Optimization

**Setup**: $100k in stablecoins with YieldMaxAI Agent

**Permissions**:

* Assets: Stablecoins only (USDC, USDT, DAI)
* Protocols: Aave, Morpho, Euler only
* Limits: $20k per transaction, 6-hour cooldown

**Results**:

* Captured 5.2% Morpho rate at 3am
* Moved to 6.1% Euler promotional rate
* Auto-claimed $312 in missed [rewards/incentives](/economics/rewards)
* Additional yield: $3,000 annually

### Agent Service Payments

**Setup**: Trading agent that needs live data feeds, inference APIs, and compute

**Permissions**:

* General Transfers: To approved [Payees](/programmable-wallets/payees) only
* Create [Cheques](/programmable-wallets/cheques): For one-off data purchases
* Assets: USDC only
* Limits: $500 per transaction, $5,000 monthly
* Cooldown: 1 hour between payments

**Results**:

* Agent keeps its data feed, inference API, and GPU provider online
* Small dataset purchases ($3-$50) clear instantly via Digital Cheques
* All spend tracked, capped, and revocable
* Agent never has custody, private keys, or unrestricted access

### Business Operations

**Setup**: Global crypto company with 30+ contractors and vendors, CFO as manager

**Permissions**:

* Recipients: Pre-approved contractor and vendor addresses only
* Limits: $2,500 per payment, $25,000 weekly
* Cooldown: 1 hour between payments
* Assets: USDC only

**Results**:

* CFO handles vendor payments independently
* Eliminated $1,750/month in wire fees
* Owner freed from payment operations
* Investment funds remain untouchable

### Family Office Trading

**Setup**: 5 professional traders as individual managers

**Permissions per trader**:

* Assets: ETH, BTC, stablecoins
* Protocols: Major DEXes only
* Limits: $100k per trade, $500k daily cap per trader
* Duration: Quarterly contracts, 3-day activation delay

**Results**:

* Risk distributed across multiple traders
* No single trader can exceed loss limits
* Each trader's P\&L tracked separately
* Underperformers removed at quarter end

### Debt Management AI

**Setup**: Ripe Protocol Debt Manager AI Agent

**Permissions**:

* Manage Debt: Repay loans, add collateral
* Manage Yield: Withdraw from Aave/Morpho for repayments
* Limits: $50k per transaction, $200k daily

**Results**:

* Maintains 150% collateralization ratio 24/7
* Auto-withdraws yield to repay when needed
* Added $15k collateral during market volatility
* Prevented liquidation during 20% market drop

### Teen Trading Education

**Setup**: 16-year-old son learning DeFi with monthly allowance

**Permissions**:

* Buy & Sell: Can swap between major tokens
* Manage Yield: Can deposit to Aave/Morpho/Euler only
* Assets: Limited to ETH, USDC, and top 10 tokens
* Limits: $100 per transaction, $500 monthly cap
* Cooldown: 30 minutes between trades
* Duration: 6-month trial period

**Results**:

* Son learns DeFi with real money, real stakes
* Losses capped at affordable education cost
* Can't access family's main holdings
* Built experience before accessing own wallet at 18

## Lifecycle Management

### Manager States

```
Added → Waiting → Active → Expired
  │        │         │        │
  └────────┴─────────┴────────┴─→ Removable anytime
           │         │
           │         └─→ Extendable (resets expiry)
           │
           └─→ Cancellable before activation
```

### Administrative Hierarchy

**You (The Owner)**

* Add, update, remove any Manager
* Modify all settings and limits
* Extend activation periods
* Ultimate control always

**The Manager**

* Can only remove themselves
* Cannot modify permissions
* Cannot add other Managers
* Prevents permission escalation

## Common Questions

**Can managers add other managers?** No. Only the wallet owner can add new managers. This prevents permission escalation attacks.

**What happens when a manager expires?** They automatically lose all permissions. No action needed from you.

**Can I change limits without removing the manager?** Yes. You can modify permissions, limits, and allowed assets/protocols anytime.

**Do unused period limits roll over?** No. Each period starts fresh with the full limit. Use it or lose it.

## Working with Other Features

### Managers and Payees

* Managers can transfer to approved [payees](/programmable-wallets/payees) within their limits
* Add payee restrictions to limit manager transfers to known addresses
* Perfect for accounts payable roles with vendor payment access

### Managers and Cheques

* Managers can create [cheques](/programmable-wallets/cheques) within their spending limits
* Cheque amounts count against manager's daily/period/lifetime caps
* Time delays on cheques add extra security layer

### Managers and Whitelist

* Managers can interact with the [whitelist](/programmable-wallets/whitelist) only if you explicitly grant whitelist-management permissions
* Once an address is whitelisted, transfers to it bypass normal payee and cheque controls
* Use whitelist for emergency access and internal capital routing; use managers, payees, and cheques for day-to-day operations


# Payees

Let agents pay for the services they need — recurring payments within exact limits

Payees are pre-approved addresses that receive payments from your [Programmable Wallet](/programmable-wallets/user-wallet) — within exact limits you control. Pre-approve recurring recipients like market data feeds, model providers, compute vendors, contractors, payroll, and subscriptions. Set per-payment caps, period limits, allowed assets, cooldowns. Your funds keep earning in DeFi until the millisecond they're needed.

Your trading agent keeps its data feed, inference API, and GPU provider online with fixed USDC allowances. Your CFO pays vendors without accessing reserves. Employees pull their exact salary. Every payment validated against your rules, every penny earning yield until sent.

## Why Payees Exist

### The Agent Payment Problem

AI agents need to pay for services to operate: data feeds for market intelligence, inference APIs for decision-making, compute providers for execution. But giving agents unrestricted spending access is dangerous — one bug or exploit could drain your wallet.

Payees solve this by pre-approving specific recipients with hard spending caps. Your trading agent can keep its data feed and GPU provider online with fixed USDC allowances — but cannot overspend, cannot add new recipients, and cannot access funds beyond its budget. The agent (as a [Manager](/programmable-wallets/managers)) can execute payments. Only you can decide who gets paid.

### The Problem with Recurring Crypto Payments

For both agents and humans, making regular crypto payments today means choosing between bad options:

* **Manual transfers**: Re-enter addresses, risk typos, waste time every pay period
* **Give full access**: Share private keys or grant unlimited spending permissions
* **Traditional banking**: Pay wire fees, lose DeFi yield, wait for processing

None of these work for agents, businesses, or individuals who need reliable, controlled automation.

### The Payee Solution

Payees create a verified recipient list with granular controls:

```
Traditional: Give vendor your credit card → They charge whatever, whenever
Underscore: Add vendor as Payee → $5,000/month limit → Only USDC → Auto-expires quarterly
```

Your funds stay in DeFi earning yield (via protocols like Aave, Morpho, Euler) until the moment of payment. The system automatically withdraws only what's needed, when it's needed. Plus, you earn [rewards](/economics/rewards) on all your DeFi activity.

## Pre-Approved Recipients, Enforced Onchain

### Owner-Controlled Recipient List

**Direct owner control**: Only you, as the [wallet owner](/programmable-wallets/user-wallet), can directly add, confirm, or widen payees. Managers can propose new payees, but those proposals stay pending until you approve them after the configured delay. Payees can remove themselves, but nobody besides you can activate or expand them. This is enforced by smart contracts, not policy.

### Tamper-Resistant Recipient Records

**Onchain recipient records**: Once a payee is configured, the recipient address and limits live onchain. A manager cannot silently swap "GPU Provider" to a different address or widen the allowance without your approval.

### Managers Can Pay, Not Expand the List

**Separation of powers**: Managers can execute payments to active payees within the configured caps. They cannot unilaterally activate new recipients, raise payee limits, or route funds to unapproved destinations. You control the recipient list. Agents and operators handle the approved flow.

This is the core payee model: recurring recipients are approved first, then payments execute only within those limits.

## Payee Controls & Configuration

You can set comprehensive controls for each payee, ensuring payments happen exactly as intended. These controls protect against overspending, timing errors, and unauthorized changes.

### Financial Limits

#### Dual Protection System

Every payee supports both token amount AND USD value limits:

* **Transaction Limits**: Maximum per single payment (e.g., 1,000 USDC or $1,000)
* **Period Limits**: Maximum per time period (e.g., 5,000 USDC or $5,000/month)
* **Lifetime Limits**: Total cumulative maximum (e.g., 50,000 USDC or $50,000)

The most restrictive limit always applies, protecting against price volatility.

#### Period Configuration

* **Custom Periods**: Set any duration in blocks (e.g., 43,200 blocks ≈ 1 day on Base)
* **Auto-Reset**: Limits refresh each period (unused amounts don't roll over)
* **Common Settings**: Daily, weekly, bi-weekly, monthly, quarterly

### Payment Controls

#### Transaction Restrictions

* **Max Transactions**: Limit payment count per period (e.g., 1 for monthly salary)
* **Cooldown Period**: Minimum time between payments (prevents accidental double-pays)
* **Expiry Date**: Auto-deactivate payees after set time (e.g., contractor end date)

#### Asset Restrictions

Control exactly which tokens each payee can receive:

* **Single Asset**: Lock to one token only (e.g., USDC for salaries)
* **Preferred Asset**: Set default with flexibility for others
* **Any Asset**: Accept all tokens (useful for trading desks)

### Security Features

#### Global Settings (Wallet-Wide)

* **Pull Payment Master Switch**: Enable/disable all pull payments
* **Self-Payment Toggle**: Allow/block payments to yourself
* **Default Limits**: Base settings inherited by new payees

#### Individual Overrides

* **Custom Limits**: Override globals for specific relationships
* **Pull Permission**: Enable per-payee even if globally disabled
* **Asset Whitelist**: Restrict tokens beyond global settings

### System Limits

* **Maximum 40 Payees**: Per wallet capacity
* **Maximum 40 Assets**: Per payee restriction list
* **Fail-Safe Protection**: Blocks payments if price oracles unavailable
* **Keep it enabled**: A broken price feed could otherwise drain your wallet
* **Only disable for**: Pure stablecoin operations where you trust the 1:1 peg

Price oracles are essential services that provide real-world asset prices to the blockchain. By blocking payments when this price data is unavailable, the system prevents potential exploits that could otherwise drain funds during an oracle malfunction.

### Pull Payment Safety

**Hard requirement**: You *cannot* enable pull payments without setting limits. The system enforces at least one cap (transaction or period) to prevent unlimited access.

## Permission System

### Who Can Add Payees

**Owner**: Full control to add, confirm, modify, or remove any payee **Managers**: Can propose new payees (requires owner approval after delay) **Others**: No access to change payees or their limits

### Who Can Execute Payments

**Owner**: Can pay any active payee within limits **Managers**: Can pay active payees only, subject to both manager and payee limits **Payees**: Can pull payments if explicitly enabled

### Who Can Remove

**Owner**: Can remove any payee immediately **Payees**: Can remove themselves (clean exit option) **Managers**: Cannot remove payees directly

## Lifecycle Management

### Activation Flow

```
Added → Pending → Active → Expired/Removed
         (delay)   (working)
```

### Typical Activation & Expiry Combinations

| Use Case                 | Activation Delay | Auto-Expiry | Why This Combo                                        |
| ------------------------ | ---------------- | ----------- | ----------------------------------------------------- |
| **New Vendor**           | 7 days           | 90 days     | High security for new relationships; quarterly review |
| **Regular Employee**     | 3 days           | 365 days    | Moderate security; annual contract cycle              |
| **Trusted Family**       | 1 day            | Never       | Quick access for emergencies; permanent relationship  |
| **Subscription Service** | 2 hours          | 30 days     | Fast setup; monthly renewal matches billing           |

### Administrative Hierarchy

**Owner (You)**

* Direct add/update/remove
* Confirm manager proposals
* Full control always

[**Managers**](/programmable-wallets/managers) — Authorized Operators

* Can make payments to active payees within limits
* Can suggest new Payees (requires your approval)
* Cannot directly activate, remove, or widen payees
* Perfect for delegating routine payments while maintaining control

**Payees**

* Can remove themselves
* Enables clean exits

> **📋 Manager Proposals Need Your Approval**\
> If a manager proposes a new payee, you'll see a pending request. After the security delay (configurable by you), you must manually confirm to activate the payee. This two-step process prevents unauthorized additions.

## Pull Payments: Optional Recipient-Initiated Billing

Enable Payees to pull payment directly from your wallet, always within your preset limits.

### How It Works

1. Payee initiates withdrawal from your wallet
2. Smart contract validates against all configured limits
3. Funds automatically sourced from yield positions if needed
4. Payment executes immediately if within limits

### Double Activation Required

```
Global: canPull = true  AND  Payee: canPull = true
                ↓
        Pull payments enabled
```

### Real Numbers

Traditional subscriptions:

* $500/month sitting idle = $0 earned

With pull payments:

* $500/month earning 5% = $25/year extra
* $6,000 annual subscriptions = $300/year bonus

**Safety**: Pull Payees MUST have limits. No unlimited access allowed.

## Real-World Configurations

### Agent Data Feed

```
Payee: Market Data Provider
Period: 30 days
Limits: $200/month, 1 transaction
Pull Enabled: Yes
Cooldown: 25 days
Asset: USDC only
Result: Agent's data feed stays online automatically
```

### Agent Compute Provider

```
Payee: GPU Compute Vendor
Period: 7 days
Limits: $500/week, $50 per transaction
Pull Enabled: No (agent pushes payment)
Asset: USDC only
Result: Compute costs capped with weekly budget resets
```

### Agent Inference API

```
Payee: Inference API Provider
Period: 30 days
Limits: $1,000/month, 50 transactions
Pull Enabled: Yes
Cooldown: 6 hours
Asset: USDC only
Result: Agent calls inference endpoint, provider pulls payment per-use
```

### Employee Payroll Configuration

```
Payee: John Smith - Developer
Limits: $5,000 bi-weekly, USDC only
Schedule: 1st and 15th of each month
Result: Automatic payment from yield-earning funds
```

### Vendor Management

```
Vendor: SupplyCo
Period: 7 days
Limits: $2k/tx, $8k/week, $100k lifetime
Cooldown: 1 hour
Asset: Any stablecoin
Result: Flexible payments within boundaries
```

### Family Support

```
Payee: College Daughter
Period: 30 days
Limits: $2k/month split across 2 payments
Asset: USDC only
Activation: 1 day delay
Result: Automated allowance, adjustable anytime
```

### SaaS Subscriptions

```
Service: Analytics Platform
Pull Enabled: Yes
Period: 30 days
Limits: $149/month, 1 transaction
Cooldown: 25 days
Asset: USDC only
Result: Never miss payment, earn yield on float
```

## Common Questions

**What happens at expiry?** Payees automatically deactivate. Payments blocked until you renew.

**What if I overpay by mistake?** Impossible. Hard limits enforced by smart contracts on the blockchain prevent sending more than configured.

**Do I need separate Payees for each employee?** Yes. Each payee has individual limits and tracking.

**Can I modify limits after setup?** Yes. Changes take effect immediately.

## The Perfect Partnership: Managers + Payees

**Payees** define which recurring recipients can receive funds. **Managers** ([Managers](/programmable-wallets/managers)) handle the approved payment flow within their own permissions and budgets.

Together, they create unbreakable security:

* You verify payment addresses once (adding them as Payees)
* Your manager handles daily operations (paying only those Payees)
* You maintain ultimate control (only you can directly activate or widen payees)

This separation of powers means you can delegate work without delegating trust. Your CFO can pay approved vendors without adding a fake recipient. Your AI can keep approved services online without routing funds to an unknown address.

For AI agents, this separation is critical. The agent (Manager) can execute payments to pre-approved service providers (Payees), but cannot add new recipients or modify spending limits. The wallet owner defines which services the agent can pay for and how much it can spend — enforced onchain, not by policy.

**Learn more**: See how [Managers](/programmable-wallets/managers) can automate your payment workflows.

## Related Features

* [**Cheques**](/programmable-wallets/cheques): One-time payments with time delays and cancellation ability
* [**Managers**](/programmable-wallets/managers): Learn how to delegate payment tasks to AI or team members
* [**Whitelist**](/programmable-wallets/whitelist): Configure instant, unlimited transfers for your most trusted addresses
* [**Programmable Wallets**](/programmable-wallets/user-wallet): Explore your agentic wallet and all its features


# Digital Cheques

One-off spend without blind trust — cancellable payments with review delays

Digital Cheques are time-locked payment promises that give you complete control until cashed. When an agent needs to pay a new counterparty, Digital Cheques turn a transfer into a controlled payment commitment. Small spends clear immediately. Larger payouts sit behind review delays and stay cancellable until they're cashed. Your funds keep earning yield until the second they're claimed.

Your agent buys a $3 dataset instantly. A $5,000 compute job waits behind a review window you can cancel. Contractor payments get built-in review time. No pre-approval needed — send to any address. Cancel anytime before cashing. Full transparency onchain for both parties.

## Why Digital Cheques Exist

### The Problem with Instant Crypto Payments

Traditional crypto transfers are irreversible the moment you click send. No grace period. No take-backs. This creates unnecessary risk for legitimate transactions where:

* You need to verify work before releasing payment
* Large amounts require extra security measures
* Payment timing needs to align with business processes
* Mistakes in addresses or amounts must be correctable

### Why Agents Need Cheques

For AI agents, Digital Cheques provide controlled one-off spending. Unlike [Payees](/programmable-wallets/payees) (which handle recurring service payments to known recipients), Cheques handle ad-hoc purchases from new counterparties — buying a dataset, paying for a one-time analysis, or acquiring temporary compute resources. Small purchases clear instantly. Larger ones get a review window where you can cancel if something looks wrong.

### The Digital Cheque Solution

Digital Cheques separate payment authorization from execution:

* **Write Now, Pay Later**: Create a payment commitment that executes on your terms
* **Cancellable Until Cashed**: Maintain control until the moment funds transfer
* **Automatic Security Delays**: Large payments get built-in review periods
* **Yield Preservation**: Funds keep earning in your wallet until payment, plus [protocol rewards](/economics/rewards)
* **One-Off Simplicity**: No recurring schedules to manage — perfect for single payments

## The Four-Stage Lifecycle

```
Creation → Time-locked → Active → Finalized
    │          │           │         │
    └──────────┴───────────┴─────────┴─→ Cancel anytime until paid
```

### Writing (Creation)

Just like filling out a paper cheque, you specify the recipient and amount. We record the USD value at this moment — think of it as writing today's date on the cheque. No money moves yet; you've just made a promise to pay.

### Dating (Time-locked)

Remember post-dated cheques? Our security delays work the same way:

* Large amounts get automatic "post-dating" for your protection
* You can set custom dates for future payments
* Your money stays in your account earning interest, just like at the bank

### Ready to Cash (Active)

The cheque is now valid and can be cashed by:

* You deciding to process it immediately
* Your [authorized assistant (Manager)](/programmable-wallets/managers) handling it
* The recipient depositing it themselves (if you enabled this)

### Cleared or Void (Finalized)

Just like a physical cheque, it ends up either:

* **Cleared**: Money successfully transferred to recipient
* **Void**: Expired uncashed or cancelled by you

## Smart Security Features

### Automatic USD Thresholds

Set a single delay threshold (e.g., $1,000):

* Below: Cheques can be immediate
* Above: Automatic delay applied

> **Note**: Cheques cannot be created for [whitelisted](/programmable-wallets/whitelist) addresses. If you trust an address enough to whitelist it, use the [Whitelist feature for instant, unlimited transfers](/programmable-wallets/whitelist) — Cheques are for addresses that need payment controls.

Example impact:

* $500 payment → No delay needed
* $5,000 payment → Security delay applied

### Time Controls

* **Expensive Delay**: How long high-value cheques wait (e.g., 3-7 days)
* **Default Expiry**: How long cheques stay active (e.g., 30 days)
* **Custom Timing**: Override per cheque as needed

Time is measured in blocks (on Base L2: \~2 seconds per block, \~43,200 blocks per day).

## Financial Controls

You can set a variety of controls and limits to ensure your Digital Cheques work exactly how you want them to. These controls help you manage risk, prevent mistakes, and maintain oversight of your payment operations. Whether you're an individual managing personal finances or a business handling vendor payments, you can customize these settings to match your specific needs and comfort level.

### Creation Limits

* **Max Active Cheques**: Total unpaid cheques allowed (e.g., 20)
* **Max Cheque Value**: Largest single cheque (e.g., $50,000)
* **Period Caps**: Monthly creation limits (e.g., $100,000)

### Payment Limits

* **Period Payment Cap**: Maximum cashed per period (e.g., $50,000/week)
* **Payment Cooldown**: Time between payments (e.g., 10 minutes)

### Asset Restrictions

Limit cheques to specific tokens:

* Stablecoins only for conservative operations
* Any token for flexible businesses
* Single asset for simplified accounting

## Permission System

### Who Can Create

**Owner**: Always can create any cheque **Managers**: Only if globally enabled AND individually permitted

### Payment Options

**Push Payment**: You or manager executes **Pull Payment**: Recipient claims when ready (must be explicitly enabled)

### Who Can Cancel

**Owner**: Any cheque, anytime before payment **Security**: Emergency cancellation rights only

## Real-World Configurations

### Agent Dataset Purchase

```
Amount: $3 USDC
Unlock: Immediate (under threshold)
Expiry: 24 hours
Pull: Enabled
Result: Agent buys a dataset instantly, no review needed
```

### Agent One-Off Service Payment

```
Amount: $500 USDC
Unlock: Immediate (under $1,000 threshold)
Expiry: 7 days
Pull: Enabled
Result: Agent pays for a one-time compute job, provider claims when ready
```

### Agent Large Purchase (With Review)

```
Amount: $5,000 USDC
Unlock: 3 days (automatic over threshold)
Expiry: 30 days
Review: Owner can cancel during 3-day delay if purchase looks wrong
Result: Large agent spend gets human review window
```

### Social Payment

```
Amount: $30 USDC
Unlock: Immediate (under threshold)
Expiry: 7 days
Pull: Enabled
Result: Friend grabs lunch money when convenient
```

### Freelance Invoice

```
Amount: $3,000 USDC
Unlock: 3 days (automatic over $1,000 threshold)
Expiry: 30 days
Pull: Enabled
Result: Client shows commitment, freelancer controls timing
```

### Monthly Rent

```
Amount: $2,500 USDC
Created: 25th of month
Unlock: 1st of next month
Pull: Enabled
Result: Landlord gets paid on time, you keep control
```

### High-Value Contract

```
Amount: $50,000 USDC
Unlock: 7 days (expensive delay)
Expiry: 45 days
Review benefit: Time to verify deliverables
Yield earned: ~$48 during delay*
```

\*Yield varies with current market rates

## The Recipient Experience

Digital Cheques are designed to be just as simple for recipients as they are secure for senders. Recipients benefit from complete transparency — they can verify a cheque's existence and terms on the blockchain before providing goods or services. Once the security delay (if any) has passed, the recipient can claim their payment at their convenience within the validity period.

This creates a trust-building dynamic: the recipient sees your commitment to pay, while you maintain the ability to cancel if something goes wrong. The blockchain ensures both parties have clear visibility into the payment status at all times, eliminating the uncertainty that often surrounds traditional payment methods.

## Advanced Features

### [Manager](/programmable-wallets/managers)-Created Cheques

Let AI or team members create cheques within your rules. Learn about [setting up Managers with cheque permissions](/programmable-wallets/managers):

1. [Manager](/programmable-wallets/managers) creates cheque from approved invoice
2. Time-lock applies automatically
3. You review during delay period
4. Cancel or let it proceed

### Smart Fund Sourcing

Like the automated payment system, cheques intelligently source funds from yield when needed:

* Check liquid balance first
* Auto-withdraw from Aave/Morpho/etc if needed
* Complete payment in one transaction

## Common Questions

**What if I send the wrong amount?**\
Cancel the cheque before it's cashed, create a new one.

**Can recipients see pending cheques?**\
Yes, full transparency onchain from creation.

**Can I modify a cheque?**\
No, but you can cancel and recreate with new terms.

**Can I write a cheque to a whitelisted address?**\
No — use [Whitelist](/programmable-wallets/whitelist) for instant payments. Cheques are for non-whitelisted recipients who need payment controls.

**What happens when a cheque expires?**\
Just like a void cheque at the bank, expired cheques become invalid automatically. The funds never leave your wallet, so they're immediately available for other uses. No action needed from you.

**Are there limits on cheque amounts or how many I can have?**\
Yes, for security. You can set maximum values per cheque and limit total active cheques. These safeguards prevent accidental overcommitment while giving plenty of flexibility for normal use.

**Can my** [**Manager**](/programmable-wallets/managers) **handle cheques for me?**\
Yes, and it's incredibly useful. You can authorize a [Wallet Manager](/programmable-wallets/managers) to create and cancel cheques within limits you set. This is perfect for businesses where your CFO handles vendor payments, or individuals who want their financial advisor to help manage large transactions. The beauty is that Managers can only operate within your pre-set boundaries — they can't exceed spending limits or change your security settings. Learn how to set up these secure delegated permissions in our guide on [Managing Your Wallet with Managers](/programmable-wallets/managers).

## Related Features

* [**Payees**](/programmable-wallets/payees): Set up automated recurring payments for regular expenses
* [**Managers**](/programmable-wallets/managers): Learn how to delegate payment tasks to AI or team members
* [**Whitelist**](/programmable-wallets/whitelist): Configure instant, unlimited transfers for your most trusted addresses
* [**Programmable Wallets**](/programmable-wallets/user-wallet): Explore your agentic wallet and all its features


# Whitelist

Instant unlimited transfers to your most trusted addresses with time-locked security

The Whitelist allows specific addresses to receive unlimited transfers from your Programmable Wallet — no spending limits, no delays, no restrictions. Perfect for your hardware wallets, cold storage, other Programmable Wallets, or emergency contacts. Move millions instantly when markets shift. Evacuate funds in seconds if compromised. Execute multi-wallet strategies at the speed of opportunity.

Add addresses with a time-locked security delay (configurable, typically 3-7 days) to prevent unauthorized additions. Remove instantly if an address becomes compromised. Every whitelisted transfer executes immediately without limits — this is your highest trust level.

## Why the Whitelist Exists

### The Problem with Three-Recipient Restrictions

Your [wallet](/programmable-wallets/user-wallet) requires every recipient to be either a [Payee](/programmable-wallets/payees) (with limits), sent via [Cheque](/programmable-wallets/cheques) (with delays), or Whitelisted. This keeps you safe but creates friction:

* **Payees**: Great for recurring payments, but limits restrict large transfers
* **Cheques**: Perfect for one-time payments, but delays kill time-sensitive opportunities
* **Missing option**: What about your own wallets that need instant, unlimited access?

When your AI agent spots arbitrage or your DAO needs treasury consolidation, [Payee](/programmable-wallets/payees) limits and [Cheque](/programmable-wallets/cheques) delays become profit killers.

### The Whitelist Solution

The Whitelist completes the payment trinity with a special category for absolute trust:

* **Your other** [**Programmable Wallets**](/programmable-wallets/user-wallet): Move millions between your own accounts instantly
* **Hardware wallets**: Secure funds without friction when threats emerge
* **Corporate treasuries**: Enable instant consolidation for business operations
* **Time-locked security**: Additions require waiting period, removals are instant
* **Manager compatible**: Delegate whitelist management without giving away funds

## How the Whitelist Works

### Payment Hierarchy

Your [wallet](/programmable-wallets/user-wallet) recognizes three types of payment recipients:

```
[Payees](payees.md) → Recurring payments with configured limits
[Cheques](cheques.md) → One-time payments with delays and cancellation
Whitelist → Instant unlimited transfers
```

Only addresses in one of these three categories can receive payments from your wallet.

### Transaction Flow

```
You initiate transfer
        ↓
Is recipient whitelisted?
        ↓
    ┌───┴───┐
    │       │
   YES      NO
    │       │
    ↓       ↓
Transfer   Is it a Payee or Cheque?
proceeds        ↓
instantly   ┌───┴───┐
            │       │
           YES      NO
            │       │
            ↓       ↓
        Apply limits  Transaction
        and proceed   BLOCKED
```

## Security Features

### Time-Locked Additions

Adding a whitelisted address follows a security delay that you control:

```
Propose → Time-Lock → Confirm → Active
Day 1      Your Choice   Ready    Until Removed
```

**This is your ultimate defense against wallet compromise.**

Every Programmable Wallet has an "owner" — the external wallet (EOA or hardware wallet) that has full control. If an attacker compromises this owner wallet, the time-lock gives you a crucial defense window.

Even with full control of your owner wallet, the attacker CANNOT immediately drain your Programmable Wallet funds. Here's why:

1. **Attacker tries to whitelist their address** → Enters time-lock period (e.g., 7 days)
2. **You see the pending addition** → You have days to respond, not minutes
3. **You immediately cancel the malicious addition** → Attacker's plan fails
4. **You transfer all funds to your pre-whitelisted cold storage** → Your money is safe

The attacker is forced to reveal their hand while you still have full control. They can't add their address instantly, can't speed up the time-lock, and can't stop you from moving funds to your already-whitelisted addresses.

This time delay transforms a successful attack into a failed attempt, giving you a critical window to protect your assets.

### Configurable Security Delay

The delay period is controlled by your wallet's `timeLock` setting, measured in blocks. You can set any duration that suits your needs — shorter for more convenience, longer for more security.

This same delay applies to all security-critical operations in your wallet, not just whitelist additions.

### Instant Removal

Unlike additions, removing whitelisted addresses takes effect immediately — protecting you when every second counts.

## Permission System

### Owner (You)

Complete authority over all whitelist operations:

* Add, confirm, cancel, remove addresses
* No restrictions on your control
* Override all other permissions
* Direct [rewards](/economics/rewards) to any whitelisted wallet

### [Managers](/programmable-wallets/managers)

Delegated whitelist powers (if granted):

* **Propose**: Suggest new addresses for your approval
* **Confirm**: Complete additions after the security delay
* **Cancel**: Stop pending additions before they activate
* **Remove**: Delete existing whitelisted addresses

Each permission must be explicitly granted — managers only get the whitelist powers you choose to give them.

### Additional Security Features

* **Owner Change Protection**: All pending additions cancel if ownership changes
* **No Cheque Creation**: Whitelisted addresses cannot receive Cheques
* **Address Validation**: Cannot whitelist empty addresses, the wallet itself, or config contracts

## Real-World Use Cases

### Multi-Wallet Strategies

**Conservative + Aggressive Split**

* Conservative wallet: Stablecoin yield farming, vendor payments
* Aggressive wallet: AI trading agent, DeFi strategies
* Instant rebalancing: Move millions between strategies as opportunities arise

Whitelist each other for instant capital deployment when your AI spots alpha.

**Security Threat Response**

* Active wallet: Daily operations, exposed to more interactions
* Secure cold storage: Maximum security setup, rarely accessed
* Instant evacuation: Move entire balance when threats emerge

When you suspect compromise or face a wrench attack, every second counts. Whitelist your secure storage to evacuate funds instantly.

### DAO & Corporate Treasury

**Multi-Signature Operations**

* Operations wallet → Main treasury: Daily revenue consolidation
* Treasury → Operations: Instant funding for opportunities
* Emergency moves: React to governance decisions immediately

**Department Management**

* Marketing wallet needs urgent campaign funding
* Development wallet requires immediate contractor payment
* Investment wallet spots time-sensitive opportunity

Whitelist between departments for operational efficiency without compromising security.

### AI Agent Operations

**Automated Strategy Execution**

* AI identifies arbitrage across protocols
* Needs immediate capital from your yield wallet
* Opportunity window: Often under 60 seconds

Without whitelist: Cheque delays or Payee limits kill the trade With whitelist: Your AI executes at market speed

## Common Questions

**Can I speed up the time-lock?**\
No. The delay is absolute for security. Plan additions in advance.

**What if I lose access to a whitelisted address?**\
Remove it immediately. A compromised whitelisted address is your highest risk.

**Can removed addresses be re-added?**\
Yes, but they go through the full process again.

**What happens if I try to send to an unapproved address?**\
The transaction will be blocked before any funds leave your wallet.

**How does the whitelist interact with my daily transfer limits?**\
Whitelisted addresses bypass ALL limits — daily, weekly, and lifetime. This is why you should only whitelist addresses you trust completely.

## Related Features

* [**Payees**](/programmable-wallets/payees): Set up automated recurring payments for regular expenses
* [**Cheques**](/programmable-wallets/cheques): One-time payments with time delays and cancellation ability
* [**Managers**](/programmable-wallets/managers): Learn how to delegate payment tasks to AI or team members
* [**Programmable Wallets**](/programmable-wallets/user-wallet): Explore your agentic wallet and all its features


# Rewards

Earn RIPE tokens through yield bonuses and deposit rewards

Earn RIPE tokens — the governance token of [Ripe Protocol](https://ripe.finance) — just by using Underscore. The more yield you generate and the more you hold, the more RIPE you earn.

**Two ways to earn:**

1. **Yield Bonuses** — Get a 1:1 RIPE match on your yield profits
2. **Deposit Rewards** — Earn RIPE based on how much you hold and for how long

Invite friends and earn RIPE on their yield profits too.

***

## Yield Bonuses (1:1 RIPE Match)

When you realize yield profits, you get bonus RIPE tokens on top:

* **1:1 match** — for every $1 of yield you earn, get $1 worth of RIPE
* Paid automatically when withdrawing yield
* Applies to yield strategies only (not swaps or reward claims)
* Requires available RIPE balance in distributor (first-come, first-served)

**Example**: You withdraw $1,000 in yield profit

* You keep your $1,000 profit (in the yield asset)
* You also receive \~$1,000 worth of RIPE tokens

### Referral Bonuses

Invite friends to Underscore and earn RIPE when they profit:

* **1:1 match** — for every $1 of yield your referred user earns, you get $1 worth of RIPE
* Your friend still gets their full 1:1 bonus too
* Both parties benefit from the same yield event

**Example**: Your friend realizes $1,000 in yield profit

* Friend keeps $1,000 profit + gets \~$1,000 RIPE bonus
* You get \~$1,000 RIPE bonus for referring them

***

## Deposit Rewards

Earn RIPE simply by holding assets in your Underscore wallet:

```
Points = (USD Value × Blocks Held)
Your Share = Your Points / Total Global Points
```

**How it works**:

1. Hold assets in your [wallet](/programmable-wallets/user-wallet)
2. Accumulate points over time
3. Claim your proportional share of the RIPE rewards pool

**Example**:

* Hold $10,000 for 2 weeks
* Total protocol points = 3,024, your points = 60.48 (2% share)
* $5,000 worth of RIPE in pool → You claim \~$100 worth of RIPE

***

## RIPE Token Details

RIPE is the governance token of [Ripe Protocol](https://ripe.finance), Underscore's integrated borrowing protocol. Your RIPE can be:

* **Held** for potential appreciation
* **Staked** in Ripe governance for voting power and additional rewards
* **Traded** on supported exchanges

### Auto-Staking

Currently, **80% of RIPE rewards are automatically staked** in Ripe's governance vault with a 180-day lock period. The remaining 20% is sent directly to your wallet. This gives you instant staking benefits without extra transactions.

***

## Fee Structure

Underscore charges small fees on certain activities:

| Activity          | Fee   | Applied To                                        |
| ----------------- | ----- | ------------------------------------------------- |
| Swaps             | 0.25% | Trade amount                                      |
| External Rewards  | 20%   | Protocol reward claims (MORPHO, WELL, etc.)       |
| Vault Performance | 20%   | Yield profits in Core Vaults and Amplified Vaults |

**No fees on**: Transfers, deposits, idle funds, or principal.

***

## Future: Ambassador Revenue Share

In addition to the RIPE yield bonuses described above, ambassadors may also receive a percentage of fees in-kind (paid in the same asset as the fee). This feature exists in the protocol but revenue share ratios are currently set to 0%. If ambassador revenue share is activated in the future, it would be deducted before the remaining protocol revenue is allocated to [$RIPE](https://app.ripe.finance/ripe) buybacks.

***

## Common Questions

**Q: When can I claim?** A: Immediately after rewards accumulate, subject to cooldown. [Managers](/programmable-wallets/managers) can claim on your behalf if authorized.

**Q: Can rewards be lost?** A: No, they accumulate until claimed (limited by contract balance).

**Q: Do bonuses always pay out?** A: Only if distributor has sufficient RIPE balance. First-come, first-served.

**Q: How do deposit points work?** A: Points = deposit value × time. More deposits + longer holding = more points = larger share of the rewards pool.

**Q: Is my RIPE automatically staked?** A: Yes. 80% is auto-staked in Ripe governance with a 180-day lock. 20% goes directly to your wallet.

***

## The Bottom Line

Earn yield, get RIPE. Hold assets, get RIPE. Refer friends, get RIPE when they profit.

Your DeFi activity directly translates to token rewards.

***

## Next Steps

* [**Deposit in Earn Vaults**](/earn-vaults/vaults): Choose Core Vaults for straightforward yield or Amplified Vaults for a second yield layer, then earn RIPE bonuses on top
* [**Deploy Your Wallet**](/programmable-wallets/user-wallet): Start accumulating deposit points
* [**Add Managers**](/programmable-wallets/managers): Automate reward claiming
* [**Set Up Whitelist**](/programmable-wallets/whitelist): Direct rewards to any trusted wallet


# Protocol Economics

How Underscore generates revenue and what happens with it

Underscore generates revenue through fees on value-generating activities. Most of that revenue comes from a 20% performance fee on vault profits, so the protocol earns when vault users earn. 100% of protocol revenue is used to buy back [$RIPE](https://app.ripe.finance/ripe) in the open market.

***

## Revenue Sources

### Vault Performance Fees (Primary)

The largest source of protocol revenue comes from [Underscore Earn Vaults](/earn-vaults/vaults). That includes both Core Vaults and Amplified Vaults.

* **Fee**: 20% of yield profits
* **Applied to**: Profits only, never principal
* **When charged**: When yield is realized

**Example**: A vault generates $100,000 in yield across all depositors

* $20,000 → Protocol revenue
* $80,000 → Distributed to depositors via increased share price

Vault performance fees scale with protocol TVL and yield performance, making this the primary revenue driver as Underscore grows.

### Swap Fees

Charged on token swaps executed through Underscore wallets.

* **Fee**: 0.25% of trade amount
* **Applied to**: All swaps (including stablecoin pairs)

**Example**: $10,000 swap → $25 fee

### External Reward Claim Fees

Charged when claiming rewards from integrated protocols (MORPHO, WELL, AERO, etc.).

* **Fee**: 20% of claimed rewards
* **Applied to**: External protocol incentives only

**Example**: Claim $200 in MORPHO rewards → $40 fee

***

## What's Free

No fees on:

* Transfers between wallets
* Deposits and withdrawals
* Idle funds
* Debt operations (borrowing/repaying)
* Liquidity provision
* ETH/WETH wrapping

***

## Revenue Allocation: $RIPE Buybacks

100% of protocol revenue is used to buy back [$RIPE](https://app.ripe.finance/ripe) in the open market.

As Underscore usage grows, buyback demand scales with it and flows back into the broader ecosystem.

**Verify onchain**: View current fee parameters in the [Params Explorer](https://params.underscore.finance/protocol).

***

## Summary

| Revenue Source    | Fee             | Relative Size             |
| ----------------- | --------------- | ------------------------- |
| Vault Performance | 20% of yield    | Largest (scales with TVL) |
| Swap Fees         | 0.25% of amount | Medium                    |
| External Rewards  | 20% of claims   | Smaller                   |

**100% of revenue →** [**$RIPE**](https://app.ripe.finance/ripe) **bought back in the open market**


# Underscore 协议

你的资金永不休眠

一个协议，两个产品。

1. [**Earn Vaults**](/zh/earn-vaults/vaults)：基于同一套份额架构的两种收益形态：核心 Vaults 提供被动的 AI 管理收益，Amplified Vaults 借助 Ripe 增加第二层收益，同时保持美元计价债务安全。
2. [**可编程钱包**](/zh/ke-bian-cheng-qian-bao/user-wallet)：让 AI 代理和操作员在你的规则内付款、再平衡和转移资金的代理式钱包。无托管。无私钥。无不受限制的访问权。

当你睡觉时，资金也在赚钱。无需手动管理。不错过任何机会。

***

## Earn Vaults

Underscore Earn Vaults 分为两种形态：

* **核心 Vaults**：封装为标准 ERC-4626 份额的 AI 管理被动收益
* **Amplified Vaults**：建立在核心 Vault 份额之上，借助 Ripe 增加第二层收益，同时保持美元计价债务安全

存入资产，获得 Earn Vault 份额，让策略在底层自动运行。

* **可组合**：Earn Vault 份额可在整个 DeFi 中使用，可交易、可桥接、可作为抵押品
* **可生息抵押品**：在 Ripe 上借款时，你的抵押品仍能继续赚取收益
* **可扩展**：100,000 个用户共享一套策略。AI 只需再平衡一次，所有人都受益

**最适合**：被动收益用户、需要可生息抵押品的协议，以及想加入直接收益或放大收益能力的金融科技应用

**→ 了解更多：**[**Earn Vaults：核心 Vaults 与 Amplified Vaults**](/zh/earn-vaults/vaults)

***

## 可编程钱包：为代理而生的资金系统

大多数代理只能提出建议。Underscore 让它们真正执行，带着真实资金，但从不接触你的私钥。

可编程钱包为 AI 代理和操作员提供严格边界内的链上执行权。[管理员](/zh/ke-bian-cheng-qian-bao/managers) 定义权限，[收款人](/zh/ke-bian-cheng-qian-bao/payees) 处理周期性支出，[数字支票](/zh/ke-bian-cheng-qian-bao/cheques) 处理带可选审核延迟的一次性付款。一切都由智能合约在链上强制执行。

### [管理员：授予代理执行权，而非托管权](/zh/ke-bian-cheng-qian-bao/managers)

授权代理去管理收益、兑换、借款、还款、领取奖励和付款。你可以按资产、协议、预算、冷却期和到期时间来限制它们。

* **细粒度权限**：只允许你明确指定的操作
* **硬性支出上限**：按日、按月和终身封顶
* **基于时间的控制**：到期后自动失效
* **即时撤销**：控制权始终在你手里

*示例：一个收益代理可以在 Aave、Morpho 和 Euler 之间再平衡，但每日上限只有 25,000 美元。*

### [收款人：让代理为自己所需的服务付款](/zh/ke-bian-cheng-qian-bao/payees)

预先批准周期性收款方，比如市场数据源、模型提供商、算力供应商、承包商、工资和订阅服务。你可以设置单笔上限、周期上限、允许资产和冷却期。

* **预先批准的收款方**，每个都有单独上限
* **自动付款**，同时资金继续赚取收益
* **支持拉取支付**，适合订阅和服务费
* **周期性上限**，防止超支

*示例：你的交易代理可以凭固定的 USDC 配额，持续支付数据源、推理 API 和 GPU 供应商。*

### [数字支票：无需盲目信任的一次性支出](/zh/ke-bian-cheng-qian-bao/cheques)

把转账变成可控的付款承诺。小额支出立即清算。较大金额会进入审核延迟，并且在兑现前始终可取消。

* **安全延迟**：保护大额付款
* **随时取消**：在实际支付前都能撤销
* **链上透明**：双方都能看到状态
* **资金不锁定**：在真正付款前都留在你的钱包里

*示例：你的代理可以立即买下一个价值 3 美元的数据集。更大的付款则会进入审核窗口。*

### [白名单：为可信地址提供即时访问](/zh/ke-bian-cheng-qian-bao/whitelist)

为你最信任的地址提供无限制访问。

* **无任何限制**：对白名单地址转账不受约束
* **时间锁添加**：增强安全性
* **即时移除**：一旦需要可立刻撤销

**最适合**：多钱包策略、硬件钱包、冷存储

> **Underscore 让代理可以动用真实资金执行操作，而无需获得托管权、私钥或不受限制的访问权。预算、收款规则、资产限制、审核延迟和到期窗口都由开源智能合约在链上强制执行。**

**→ 了解更多：**[**可编程钱包**](/zh/ke-bian-cheng-qian-bao/user-wallet)

***

## 一切如何协同工作

你的 Underscore 基础设施并不只是单一功能，而是一整套彼此协同的智能体系。

### 代理的一天

**凌晨 3 点**：你的[收益代理](/zh/ke-bian-cheng-qian-bao/managers) 发现 Morpho 的收益率比 Aave 高 1%。它在每日 25,000 美元上限内自动再平衡 25,000 美元，而你还在睡觉。

**早上 6 点**：你的交易代理的数据订阅续费了。200 USDC 从它的[收款人](/zh/ke-bian-cheng-qian-bao/payees) 配额中自动扣款。代理继续运行。

**上午 10 点**：交易代理需要为回测购买一次性数据集。它创建了一张价值 3 美元的[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)，因为低于审核阈值，所以立即清算。

**下午 2 点**：一笔价值 5,000 美元的算力任务需要付款。代理创建一张带 3 天审核窗口的支票。如果你发现异常，可以直接取消。

**晚上 11 点**：你的投资组合今天在 5 个协议之间完成了 3 次再平衡。代理也支付了它自己的服务成本。你什么都没做，也没有共享任何私钥。

### 人的一天

**上午 10 点**：该交月租了。你的房东（配置为[收款人](/zh/ke-bian-cheng-qian-bao/payees)）准确提走 2,500 USDC，一分钱不多。剩余资金继续赚取收益。

**下午 2 点**：你需要支付承包商。创建一张 5,000 美元、带 3 天延迟的[支票](/zh/ke-bian-cheng-qian-bao/cheques)。如果对方没有交付，直接取消。

**下午 4 点**：该给你的交易钱包充值了。把 20,000 美元即时转到另一个已加入[白名单](/zh/ke-bian-cheng-qian-bao/whitelist)的可编程钱包。

***

## 谁在使用 Underscore

Underscore 不是一款面向消费者的应用，而是面向代理、应用和协议的基础设施。你可以把它理解成 DeFi 世界里的 AWS，但它完全非托管。

### 基于 Underscore 构建的应用

* **AI 代理与自主系统**：作为[管理员](/zh/ke-bian-cheng-qian-bao/managers)在用户设定限制内运行的收益优化代理、交易机器人和自主经济体，并通过[收款人](/zh/ke-bian-cheng-qian-bao/payees)和[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)支付数据、算力和推理 API
* **金融科技应用**：比如 [Hightop](https://hightop.com)，它利用 Underscore 提供面向 AI 代理的数字银行，让人类也能轻松使用，并让代理在用户保持控制权的同时付款、收款、让闲置资金持续赚取收益并转移资金
* **Vault 集成方**：无需自建基础设施，直接集成[核心 Vaults](/zh/earn-vaults/vaults)即可提供被动收益，或围绕 [Amplified Vaults](/zh/earn-vaults/vaults) 提供第二层收益
* **支付平台**：跨境汇款、B2B 付款和薪资系统，可以直接利用我们的[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)和[收款人](/zh/ke-bian-cheng-qian-bao/payees)
* **钱包提供商**：为现有钱包加入更高级的 DeFi 能力和[可编程委托](/zh/ke-bian-cheng-qian-bao/managers)

### Hightop 示例

Hightop 展示了基于 Underscore 构建的强大能力：

* **面向 AI 代理的数字银行，让人类也能轻松使用**：Hightop 为代理资金提供干净的产品体验，而底层的可编程控制层由 Underscore 提供
* **让代理付款并收款。控制权始终在你手中。**：Hightop 将代理执行映射到[管理员](/zh/ke-bian-cheng-qian-bao/managers)，将周期性对手方映射到[收款人](/zh/ke-bian-cheng-qian-bao/payees)，将一次性付款映射到[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)，将可信出金路径映射到[白名单](/zh/ke-bian-cheng-qian-bao/whitelist)
* **钱包、Gas 和资金流转都在后台处理**：Hightop 抽象掉[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)基础设施、Gas 和资金流转，而 Underscore 在链上强制执行限额、权限和支付规则
* **Earn Autopilot 与投资组合执行运行在 Underscore 之上**：[核心 Vaults](/zh/earn-vaults/vaults)、[Amplified Vaults](/zh/earn-vaults/vaults)和 Underscore Lego 负责收益、兑换以及在 25+ 种支持资产上的策略感知型资产执行，而 Ripe 负责借贷层以及 Amplified Vault 背后的杠杆轨道
* **x402 流程已就绪，卡片即将推出**：Hightop 已经支持面向代理的 API 原生入账支付，并正在把同一套控制模型扩展到虚拟卡

大多数用户永远不会直接接触 Underscore。他们会通过像 Hightop 这样的应用，享受由 Underscore 基础设施支撑的无缝体验。

**→ 了解更多：**[**谁在使用 Underscore**](/zh/kai-shi-shi-yong/who-uses-underscore)

***

## 常见问题

**我的钱包可升级吗？** 不能。出于安全考虑，钱包代码是不可变的。新功能会通过 Lego 集成进入系统。如果未来需要新功能，你可以迁移到新的可编程钱包。

**什么是 Lego？** 它是与 DeFi 协议交互的标准化集成层。新协议上线后，你的钱包可以立即使用。

**我可以同时使用多个钱包吗？** 可以。把它们加入白名单后，就能在钱包之间即时转账。

**L2 支持情况如何？** 目前仅支持 Base L2。更多链后续会加入。

**费用怎么收？** 兑换收取 0.25%，外部奖励领取收取 20%。Earn Vaults 仅对收益利润收取 20% 的业绩费。转账、存款和闲置资金不收费。100% 的协议收入都用于在公开市场回购 [$RIPE](https://app.ripe.finance/ripe)。更多细节见 [协议经济模型](/zh/jing-ji-mo-xing/protocol-economics)。

**如果我丢了所有者钱包怎么办？** 如果你事先已经设置好管理员和白名单地址，管理员仍然可以把资金转到你的白名单地址（例如硬件钱包），为你提供恢复路径。

**管理员能偷走我的钱吗？** 不能。管理员始终受链上限制约束。他们只能在你的支出上限内执行被授权的操作，不能向外部地址提现，也不能修改自己的权限。

**紧急转账怎么处理？** 提前把你的硬件钱包或安全地址加入白名单。和有限额的收款人、带延迟的支票不同，白名单地址可以在紧急情况下即时接收无限额转账。

***

## 支付方式对比

理解不同场景下该使用哪种支付工具：

| 功能       | [**白名单**](/zh/ke-bian-cheng-qian-bao/whitelist) | [**收款人**](/zh/ke-bian-cheng-qian-bao/payees) | [**数字支票**](/zh/ke-bian-cheng-qian-bao/cheques) |
| -------- | ----------------------------------------------- | -------------------------------------------- | ---------------------------------------------- |
| **使用场景** | 向可信地址进行即时、无限额转账                                 | 自动化的周期性付款                                    | 带控制能力的一次性付款                                    |
| **支付上限** | 无，完全无限制                                         | 可按收款方自定义                                     | 每张支票单独设置                                       |
| **设置时间** | 需要时间锁添加（可配置）                                    | 带上限即可立即使用                                    | 无需提前设置                                         |
| **核心优势** | 紧急访问和多钱包策略                                      | 配置一次，持续自动运行                                  | 在兑现前可随时取消                                      |
| **最适合**  | 硬件钱包、冷存储、其他钱包                                   | 代理服务、薪资、订阅                                   | 代理采购、承包商、大额转账                                  |
| **风险等级** | 最高，理论上可直接转空钱包                                   | 中等，受上限保护                                     | 最低，可取消                                         |

***

## 开始使用

### 快速开始

**想要被动收益？（2 分钟）**

1. 将你的钱包连接到 Underscore
2. 选择一个收益形态：核心 Vaults 用于被动收益，Amplified Vaults 用于收益放大
3. 存入资产，接下来交给 AI

**想构建 AI 代理？（10 分钟）**

1. 部署一个[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)
2. 把你的代理添加为[管理员](/zh/ke-bian-cheng-qian-bao/managers)，并设置权限和预算
3. 配置[收款人](/zh/ke-bian-cheng-qian-bao/payees)，用于支付周期性服务成本（数据、算力、API）
4. 用[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)处理一次性付款

**想拥有完全控制？（5 分钟）**

1. 部署你的[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)
2. 根据需要添加管理员、收款人或白名单地址
3. 在同一个入口访问 20+ 个 DeFi 协议

### 探索功能

**如果你想要被动收益**：从[核心 Vaults](/zh/earn-vaults/vaults)开始，存入资产，让 AI 自动优化。无需先部署钱包。

**如果你想要放大收益**：探索 [Amplified Vaults](/zh/earn-vaults/vaults)，在保持 BTC 或 USDC 敞口的同时，借助 Ripe 增加第二层收益。

**如果你在构建 AI 代理**：部署一个[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)，然后配置[管理员](/zh/ke-bian-cheng-qian-bao/managers)负责执行、[收款人](/zh/ke-bian-cheng-qian-bao/payees)负责周期性成本、[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)负责一次性支出。

**如果你想获得完全控制**：部署一个[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)，再按需探索：

* **需要自动化**：使用[管理员](/zh/ke-bian-cheng-qian-bao/managers)委托执行
* **需要周期性付款**：使用[收款人](/zh/ke-bian-cheng-qian-bao/payees)配置自动转账
* **需要一次性付款**：使用[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)并保留取消能力
* **需要多钱包策略**：把地址加入[白名单](/zh/ke-bian-cheng-qian-bao/whitelist)
* **需要赚取奖励**：了解[收益分享与奖励加成](/zh/jing-ji-mo-xing/rewards)

***

## 技术文档

面向开发者和集成方：[完整技术文档](https://underscore-1.gitbook.io/developers/)

你可以基于 Underscore 的基础设施进行开发，其中包含智能合约架构、Lego Partner 集成和安全模型的详细说明。已有 30 多个生产级合约文档和集成示例。

如需查看实时协议参数与合约部署，请访问 [Params Explorer](https://params.underscore.finance)。

***

## 社区与支持

* **Discord**：[discord.gg/hightop](https://discord.gg/hightop)
* **Twitter/X**：[@underscore\_hq](https://x.com/underscore_hq)
* **GitHub**：[github.com/underscore-finance](https://github.com/underscore-finance/underscore-protocol)

***

## 金融操作的未来

AI 代理需要的不只是 API，它们还需要资金。需要能够在安全边界内自主支付服务费用、捕捉收益并转移资金。

Underscore 兑现了加密货币的核心承诺：像你一样努力工作的可编程资金。你的代理在不可突破的边界内执行策略。你的资金在多个协议中持续赚钱，同时保留支付流动性。你的安全措施在保护你的同时，不妨碍效率。

Earn Vaults + 可编程钱包。你的资金永不休眠。


# 谁在使用 Underscore

面向通过可编程支付和 Earn Vaults 构建产品的代理、应用与协议的基础设施

Underscore 是面向代理、应用与协议的基础设施。有些用户通过 Hightop 这样的应用感知到它，这类应用利用 Underscore 提供面向 AI 代理的数字银行，让人类也能轻松使用；有些通过运行在可编程钱包中的 AI 系统感知到它；而大多数终端用户甚至不会知道它的存在。

你可以把 Underscore 理解成 DeFi 世界里的 AWS，但它完全非托管。就像数百万人在使用 Netflix 时不会意识到 Amazon 的服务器一样，未来也会有数百万人使用由 Underscore 基础设施驱动的金融应用。关键区别在于：用户始终保有对自己资金的控制权。复杂度被藏在底层，用户享受的是顺滑体验。

Underscore 提供两类核心产品：任何人都能使用的 [**Earn Vaults**](/zh/earn-vaults/vaults)，其中包括核心 Vaults 和 Amplified Vaults；以及 [**可编程钱包**](/zh/ke-bian-cheng-qian-bao/user-wallet)，配合[管理员](/zh/ke-bian-cheng-qian-bao/managers)、[收款人](/zh/ke-bian-cheng-qian-bao/payees)、[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)和[白名单](/zh/ke-bian-cheng-qian-bao/whitelist)，让 AI 代理和操作员在链上规则内使用真实资金执行操作。

## 激励一致的经济模型

* 协议在用户赚钱时才赚钱：Underscore 的大部分收入来自仅针对 Vault 利润收取的 20% 业绩费
* 额外的小额收入来自兑换费用和外部奖励领取费用
* 存款、转账、闲置资金和本金不收费
* 100% 的协议收入都用于在公开市场回购 [$RIPE](https://app.ripe.finance/ripe)
* 费用细节、示例和链上验证可查看 [协议经济模型](/zh/jing-ji-mo-xing/protocol-economics)

## Underscore 生态系统

### 谁在 Underscore 上构建

**金融科技应用**

* 需要 DeFi 收益能力的面向消费者应用
* 提供加密服务的新型银行
* 需要自动化资金流的支付处理平台
* 希望通过 [Earn Vaults](/zh/earn-vaults/vaults) 快速加入收益功能的应用，无论是核心 Vaults 的被动收益，还是 Amplified Vaults 的第二层收益

**加密钱包**

* 想加入高级 DeFi 功能的钱包
* 需要[可编程委托](/zh/ke-bian-cheng-qian-bao/managers)的钱包提供商
* 需要自动化能力的多签方案

**AI 代理与自治系统**

* **收益优化代理**：以[管理员](/zh/ke-bian-cheng-qian-bao/managers)身份运行在可编程钱包中，在严格预算和协议限制内 24/7 在 Aave、Morpho、Euler、Compound 等协议之间再平衡
* **交易代理**：通过[收款人](/zh/ke-bian-cheng-qian-bao/payees)向市场数据源、推理 API 和算力供应商支付固定预算，维持自身基础设施持续在线
* **自主经济体**：用[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)处理一次性采购，例如数据集、临时算力或分析报告，并为大额采购保留审核延迟
* **代理编排平台**：在单个可编程钱包上部署多个代理，为每个代理分配独立的管理员权限、预算和资产限制

Underscore 让代理能够动用真实资金执行操作，而无需托管权、私钥或不受限制的访问权。预算、收款规则、资产限制、审核延迟和到期窗口都由链上代码强制执行。

**企业解决方案**

* B2B 支付平台
* 企业资金管理
* DAO 财务运营
* 机构级 DeFi 接入

### 终端用户如何体验 Underscore

用户在友好的应用界面中交互，而 Underscore 处理所有复杂度：

* **赚取收益**：“存入 USDC，赚 8% 年化” → [核心 Vaults](/zh/earn-vaults/vaults) 自动路由至最优协议
* **发起付款**：“给承包商转 500 美元” → Underscore 的[支票系统](/zh/ke-bian-cheng-qian-bao/cheques)负责安全控制
* **投资组合管理**：“让 AI 帮我优化收益” → Underscore 的[管理员](/zh/ke-bian-cheng-qian-bao/managers)负责执行策略
* **资产兑换**：“把 ETH 换成 USDC” → Underscore 在各个 DEX 之间寻找最佳价格
* **借款**：“用我的 ETH 作为抵押借钱” → Underscore 的 Ripe Protocol Lego 安全管理抵押品
* **可生息抵押品**：“把我的收益份额拿去做抵押” → [核心 Vault 份额](/zh/earn-vaults/vaults) 可在 Ripe 上继续生息

用户看到的是简单界面。Underscore 负责繁重的底层工作。

## 案例研究：Hightop

[Hightop](https://hightop.com) 是面向 AI 代理的数字银行，让人类也能轻松使用。让代理付款并收款。控制权始终在你手中。

Hightop 在后台处理[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)基础设施、Gas 和资金流转。

在底层，Underscore 为代理权限、支付、提现、Earn Autopilot 和投资组合执行提供资金控制与执行层。Hightop 的 Earn Autopilot 同时使用核心 Vaults 与 Amplified Vaults，而借贷以及 Amplified Vault 背后的杠杆轨道由 Ripe 提供。

### Hightop 为用户提供什么

通过一个应用，Hightop 用户可以：

* **为账户注资**，并通过熟悉的渠道转入和转出资金
* **为每个代理设置限额、权限和支付规则**
* **让代理付款、收款、赚取收益、借款、投资和转移资金**，而无需把私钥或不受限制的钱包访问权交给它们
* **在一个简单的应用里管理一切**，同时把[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)基础设施、Gas 和资金流转隐藏在后台，并让控制层保持链上可验证

### Underscore 如何驱动这些功能

**代理控制层**

* Hightop 的代理控制配置映射到 Underscore 的[管理员](/zh/ke-bian-cheng-qian-bao/managers)
* 钱包级与按代理划分的规则定义每个代理能做什么、能接触哪些资产和场所、能向谁付款、能花多少钱以及何时到期
* 关键边界由不可变的开源智能合约在链上强制执行，而不是只靠应用后端记住
* 这种信任模型依赖的是透明的链上智能合约基础设施，而不是隐藏在应用背后的不透明资产负债表式托管

**支付与资金流转**

* 已批准的周期性对手方映射到 Underscore 的[收款人](/zh/ke-bian-cheng-qian-bao/payees)
* 临时付款和大额采购使用带可选审核延迟和取消窗口的[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)
* 可信出金与自托管路径使用[白名单](/zh/ke-bian-cheng-qian-bao/whitelist)，可即时转到已批准地址
* 代理也可以通过一次性、按使用量计费以及兼容 x402 的 HTTP 流程收款。研究代理可以按请求收费，支持代理可以按工作流收费
* 这就是 Hightop 如何在不给代理开放式账户权限的前提下，让它们可以向供应商付款、收款并转移资金

**Earn Autopilot**

* Hightop 的 Earn Autopilot 使用 Underscore 的收益 Lego，再加上[核心 Vaults](/zh/earn-vaults/vaults)和[Amplified Vaults](/zh/earn-vaults/vaults)，让闲置现金在多种收益策略下持续赚取收益
* Hightop 的 AI 自动驾驶可以在不让用户接触协议复杂度的前提下，尽可能提高收益并协助管理投资组合

**投资组合执行**

* 兑换和投资组合调整通过 Underscore 的 DEX 集成完成
* 代理可以在 Aerodrome、Uniswap、Curve 等场所买入支持资产、按投资组合目标再平衡，并执行已批准的策略
* 执行会始终遵守策略约束，因此代理可以朝目标仓位再平衡并轮动敞口，而不会脱离脚本

**卡片（即将推出）**

* Hightop 也在强调同一套控制模型之上的虚拟卡能力，即将推出
* 每个代理都可以拥有自己的虚拟卡，支出规则在链上强制执行，并且可以在刷卡瞬间从 Earn 余额自动补足资金

**借款**

* Hightop 把借款呈现为一个简单的应用内功能
* 借贷层由 Ripe 提供，Amplified Vault 背后的杠杆轨道同样由 Ripe 提供；而 Underscore 负责外围的代理控制、[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)权限模型以及代理执行模型

### Hightop 用户体验

从用户视角看：

1. 下载 [Hightop](https://hightop.com) 应用
2. 通过熟悉的银行或加密货币渠道为账户注资
3. 创建一个代理并给它清晰的规则
4. 让这个代理在自己的权限范围内付款、收款、赚取收益、投资或保护投资组合
5. 需要时借款，并随时提现到可信地址

他们永远看不到的是：

* 20+ 个协议的代币授权
* 收益协议比较与现金路由逻辑
* 滑点计算
* 智能合约交互
* 代理权限、付款路径规则与支出护栏
* 任何关于 Gas、私钥或助记词的概念

他们只是在使用一个干净的产品，而资金层依然保持可编程。这就是基于 Underscore 构建产品的力量。

## 案例研究：AI 交易代理

一个交易代理需要自主运行：再平衡头寸、支付数据源费用、偶尔购买数据集，而且整个过程不能依赖托管或私钥。

### Underscore 如何为这个代理提供能力

**执行层（**[**管理员**](/zh/ke-bian-cheng-qian-bao/managers)**）**

* 代理被配置为某位钱包所有者的可编程钱包上的管理员
* 权限：买卖、管理收益、向已批准收款人进行通用转账
* 限制：每日 25,000 美元，仅限稳定币，仅限已批准协议
* 时间控制：6 小时冷却期，90 天到期，可续期

**周期性成本（**[**收款人**](/zh/ke-bian-cheng-qian-bao/payees)**）**

* 数据供应商：每月 200 美元的拉取支付
* 推理 API：每月 1,000 美元，最多 50 笔交易
* 算力供应商：每周 500 美元

**一次性采购（**[**数字支票**](/zh/ke-bian-cheng-qian-bao/cheques)**）**

* 100 美元以下的数据集采购：即时到账
* 更大支出：3 天审核窗口，可由钱包所有者取消

**代理永远不会拥有：**

* 私钥
* 添加新付款对象的能力
* 超出预算的访问权
* 操作受限资产的权限

代理可以动用真实资金执行，但钱包所有者仍拥有完整控制权。所有边界都由链上规则强制执行。

## 非常适合 Vault 集成

这是向任何应用加入 AI 管理收益的最快方式。

### 为什么集成 Vaults

Underscore Earn Vaults 共享同一套架构，但有两种收益形态：核心 Vaults 提供直接的 AI 管理收益，Amplified Vaults 通过 Ripe 叠加第二层收益。

**对金融科技应用来说**

跳过数月的基础设施开发，直接集成 [核心 Vaults](/zh/earn-vaults/vaults)，或围绕 [Amplified Vaults](/zh/earn-vaults/vaults) 构建第二层收益能力：

* 标准 ERC4626 接口，集成工作量极低
* AI 优化完全由 Underscore 负责
* 用户通过你的界面存款，你只需跟踪份额
* 你不需要自己搭建钱包基础设施

**对 DeFi 协议来说**

让抵押品变得可生息：

* 接受核心 Vault 份额作为抵押品
* 用户借款的同时继续赚取收益
* 标准 ERC20 兼容性
* Vault 价值可在链上追踪

**对投资组合管理者来说**

无需自建基础设施，也能提供托管式策略：

* 通过核心 Vaults 提供直接的收益优化
* 通过 Amplified Vaults 提供有风险控制的放大收益
* 可以白标为你自己的产品
* 把精力放在获客，而不是基础设施

### 示例：快速集成 Vault

某个支付应用想让用户沉淀资金也能赚收益：

```
传统做法：
- 自建收益基础设施（3-6 个月）
- 集成多个协议（持续维护）
- 自己实现再平衡逻辑（安全风险）
- 全部重新审计（$$$$）

Vault 做法：
- 用用户资金调用 deposit()
- 在内部跟踪用户份额
- 提现时调用 redeem()
- 2 周内完成
```

Vault 负责协议选择、再平衡、奖励领取和风险管理。应用只需要专注用户体验。

***

## 非常适合支付类应用

Underscore 的支付基础设施使其非常适合下一代支付产品：

### 跨境汇款应用

通过以下方式升级国际转账体验：

* 用 [**数字支票**](/zh/ke-bian-cheng-qian-bao/cheques) 提供安全、可取消、带内置防欺诈的转账
* 用 [**收款人**](/zh/ke-bian-cheng-qian-bao/payees) 处理有限额的周期性家庭汇款
* 用稳定币实现 **即时结算**，同时在等待领取期间继续赚取收益
* 借助 **拉取支付**，让收款人在汇率更合适时再提款

### B2B 全球支付平台

通过以下方式改造企业付款：

* 使用 [收款人](/zh/ke-bian-cheng-qian-bao/payees) 处理带 net-30/60/90 账期的 **自动开票**
* 使用 [数字支票](/zh/ke-bian-cheng-qian-bao/cheques) 与审批流程实现 **类托管功能**
* 让 **多币种资金库** 在付款周期之间继续赚取收益
* 通过 [管理员](/zh/ke-bian-cheng-qian-bao/managers) 为财务团队提供 **委托式付款审批**

### 薪资与报销平台

让员工支付体系现代化：

* **拉取式工资**，由员工提取自己应得的确切金额
* **报销管理**，自动附带限额与审批
* 使用可取消的 [**数字支票**](/zh/ke-bian-cheng-qian-bao/cheques) 支付承包商
* 通过 [管理员](/zh/ke-bian-cheng-qian-bao/managers) 权限实现 **多层级审批链**

### 为什么支付要选 Underscore？

* **可编程资金**：为每一段付款关系设置精确规则
* **沉淀资金也能生息**：资金直到真正用掉前都在赚 DeFi 收益
* **防欺诈**：时间锁、取消能力和限额共同保护用户
* **全球即时结算**：没有银行营业时间，也不需要中转银行
* **更友好的合规性**：清晰的审计轨迹和权限体系

## 开发者为什么选择 Underscore

**更快上市**

* 用数周而不是数月上线 DeFi 功能
* 一次集成即可接入所有主流 DeFi 协议
* 预构建的委托与支付系统
* 从第一天起就可投入生产的智能合约

**降低风险**

* 经过实战验证的安全模式
* 用户资金受时间锁和权限保护
* 每笔交易都有清晰的审计轨迹
* 没有无限额代币授权或 honeypot 风险

**面向未来**

* 新协议会通过 Lego 自动开放
* 协议更新时无需重新集成
* 为多链扩展而设计
* 新增协议由社区推动

## 未来：无形的基础设施

随着 Underscore 发展，它会变得越来越“不可见”。用户不会再问“这是不是用了 Underscore？”，就像他们不会问“这是不是用了 HTTPS？”一样。它会自然成为以下场景的标准：

* **每一个金融科技应用** 都提供 DeFi 收益能力
* **每一个钱包** 都拥有高级功能
* **每一个 AI 代理** 都能管理投资组合并支付自己的服务成本
* **每一个平台** 都需要支付自动化

最好的基础设施，总是消失在背景中，让体验像魔法一样自然。

***

## 加入这场变革

准备好基于 Underscore 构建产品，或者进一步了解金融基础设施的未来了吗？

### 联系我们

* **Discord 社区**：加入我们的开发者讨论 [discord.gg/hightop](https://discord.gg/hightop)
* **关注动态**：在 Twitter/X 上关注 [@underscore\_hq](https://x.com/underscore_hq)
* **GitHub**：在 [github.com/underscore-finance](https://github.com/underscore-finance/underscore-protocol) 查看代码

无论你是在构建下一个十亿美元级金融科技公司、优化支付流程，还是在打造 AI 驱动的金融工具，我们的社区都可以帮助你推进。

***

记住：最好的基础设施会隐于幕后。Underscore 负责处理复杂性，让开发者能够构建出让代理、应用与操作员安全转移真实资金的产品。


# DeFi 集成

通过你的 Underscore 钱包可访问的完整 DeFi 协议列表

你的 Underscore 钱包通过称为 “Lego” 的标准化适配器连接到 20+ 个 DeFi 协议。以下是当前可用的完整列表。

## 收益与借贷协议

| 协议                | 类型  | 你可以做什么                          |
| ----------------- | --- | ------------------------------- |
| **Aave V3**       | 借贷  | 存入获取收益                          |
| **Morpho**        | 借贷  | 具有竞争力利率的隔离借贷市场                  |
| **Compound V3**   | 借贷  | 存入获取收益                          |
| **Euler**         | 借贷  | 存入获取收益，使用隔离借贷市场                 |
| **Fluid**         | 借贷  | 存入获取收益                          |
| **Moonwell**      | 借贷  | Base 原生借贷协议                     |
| **Ripe Protocol** | 稳定币 | 以任意抵押品借入 GREEN/sGREEN           |
| **Sky PSM**       | 稳定币 | MakerDAO 的 Peg Stability Module |
| **40 Acres**      | 收益  | 专门化收益策略                         |
| **Wasabi**        | 收益  | 收益优化                            |
| **Avantis**       | 收益  | 收益聚合                            |
| **ExtraFi**       | 收益  | 额外收益来源                          |

## 去中心化交易所

| 协议             | 类型    | 你可以做什么                               |
| -------------- | ----- | ------------------------------------ |
| **Aerodrome**  | DEX   | 兑换、提供 LP（Classic + Slipstream 集中流动性） |
| **Uniswap V2** | DEX   | 兑换、基础流动性提供                           |
| **Uniswap V3** | DEX   | 兑换、集中流动性（NFT 头寸）                     |
| **Curve**      | 稳定币兑换 | 低滑点稳定币兑换、提供 LP                       |

## 协议访问会自动扩展

你的钱包具备面向未来的能力。当新协议被集成后：

* 无需迁移
* 无需更新钱包
* 只要新的 Lego 部署完成就会自动可用
* 你现有的全部安全设置仍然生效

**实时数据**：在 [Params Explorer](https://params.underscore.finance/legos) 中查看所有已激活的集成及其链上状态。

## 协议安全性

所有已集成协议都：

* 具备可观的 TVL
* 经过知名安全公司审计
* 已在主网上经受实战检验

Underscore 只会集成符合严格安全标准的协议。

## 什么是 Lego？

Lego 是让你的钱包接入各个协议的标准化适配器。它们在统一接口后面处理不同智能合约的交互复杂度。

**Lego 架构的优势**：

* **简单**：所有协议都通过同一种接口访问
* **安全**：适配器经过审计，并内置保护机制
* **面向未来**：新协议会自动可用
* **可组合**：可在单笔交易中组合多个协议操作


# Earn Vaults：核心 Vaults 与 Amplified Vaults

Earn Vaults 将核心 Vaults 的被动 AI 管理收益与 Amplified Vaults 的 Ripe 驱动收益放大结合在一起

Underscore Earn Vaults 共享同一套架构，提供两种收益形态：

* **核心 Vaults**：封装为标准 ERC-4626 份额的 AI 管理被动收益
* **Amplified Vaults**：建立在核心 Vault 份额之上，借助 Ripe Protocol 增加第二层收益，同时将借入部分始终限定在美元计价策略中

Earn Vaults 是非托管的。资产始终属于你。你可以随时提取，无需任何额外许可。

它与[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)最大的不同在于：你的头寸不会被锁死。Vault 份额是可组合代币，可以在整个 DeFi 中使用。你可以交易、将其作为抵押品，或跨链桥接。无论这些代币被转移到哪里，底层策略都会继续运行。

***

## 为什么会有 Earn Vaults

### 起源

Vaults 并不是凭空设计出来的，而是源于我们在实际构建过程中遇到的真实问题。

我们最早从 [Hightop](https://hightop.com) 开始。Hightop 利用 Underscore 提供面向 AI 代理的数字银行，让人类也能轻松使用。其中最早的一条工作流，就是 Earn Autopilot：让闲置现金持续赚取收益、监控市场、并将独立的[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)再平衡到更好的收益机会。它确实能工作，但我们很快撞上了天花板：每一次优化都意味着要触碰每个钱包。如果我们想把同一套改进后的策略推广给 10,000 个用户，就意味着 10,000 笔独立交易。成本高、速度慢，而且代理在为想要同样结果的用户重复做同一份工作。

随后是 Ripe Protocol。用户会拿自己的收益头寸作抵押品，例如 Aave 存款、Morpho 头寸等等。但一旦这些资产变成抵押品，它们就被锁住了。即便后来出现更优收益机会，用户也无法在不先还清贷款的情况下重新平衡这些抵押品。那些本应继续赚取收益的资产就这样卡住了。

这两个问题都来自同一个地方：真实用户、真实使用场景、真实反馈。我们在 Hightop 中亲身体会到了，把收益自动化扩展到大规模独立钱包时的低效。

于是我们构建了 Earn Vaults。核心洞察是：保留我们在可编程钱包里已经建立起来的一切，AI 能力、清晰边界、链上规则和策略，但只给 AI 管理一个“钱包”。用户把资金存入一个共享 Vault，收到代表份额的代币。AI 优化一次，所有人都受益。由于核心 Vault 份额是标准代币，它们还能在 Ripe 上作为抵押品使用，而底层 AI 会继续优化这些头寸。

这种架构也打开了通往新 Vault 类型的大门：Amplified Vaults、指数型 Vault 等，都可以建立在同一套基础之上。

如今，Earn Vaults 已经上线，而核心 Vaults 与 Amplified Vaults 都已经在 Hightop 的实时 Earn Autopilot 体验中投入生产使用。

### 可扩展性

一个 Vault，一次再平衡，所有人受益。

这就是我们扩展到数百万用户的方式。

### 可组合性

核心 Vault 份额是标准 ERC-20 代币。这带来了：

* **抵押能力**：在 Ripe Protocol 上使用核心 Vault 份额借款，而 AI 会继续优化你的抵押品，即便它已经被锁定
* **流动性**：可在流动性池中出售份额，实现即时退出
* **可迁移性**：可跨链桥接，也可在其他协议中使用
* **易集成**：任何应用都可以通过标准接口集成 Earn Vaults

你的头寸会变成积木，而不是被锁住的资产。

### 简洁性

追逐收益是一件很累的事。盯着 Morpho 的利率、比较 Aave 市场、追踪 Euler 的激励活动、赶在奖励过期前领取收益，这几乎是一份全职工作。

核心 Vaults 把这些全部接管了。用户只需要存入资产、拿到一个代币，然后赚取收益。所有复杂度，包括多协议策略、AI 再平衡、风险管理、奖励领取和复投，都会在幕后完成。

***

## 核心 Vaults 如何运作

为你的资产提供简单的收益优化。

### 工作方式

1. **存入**：把 USDC、ETH 或其他受支持的资产存入 Vault
2. **获得份额**：收到代表你在池中份额的 Vault 代币（例如 `_USDC`）
3. **AI 优化**：代理在已批准的协议、Vault 和收益策略之间进行再平衡
4. **随时提取**：任何时候都可以把份额赎回成底层资产

### AI 在做什么

AI 代理会持续优化 Vault 的头寸：

* **持续监控**：跟踪 Morpho、Euler、Moonwell、Aave、Fluid、Compound 等已批准协议的利率、流动性、激励和提取条件
* **风险调整后的路由**：不只看名义 APY，还会分析存款人数、总存款、利用率和可提取流动性，再决定是否迁移资金
* **自动再平衡**：随着条件变化，把资金迁移到风险收益比更优的地方
* **奖励收割**：自动领取并复投协议激励

### 示例：USDC 核心 Vault

**你存入 10,000 USDC**：

* Vault 总规模为 1,000,000 USDC，份额价格为 1.00 美元
* 你收到 10,000 枚 `_USDC`

**3 个月后**：

* AI 已执行数十次再平衡，捕捉利率机会、在迁移前评估风险、轮动参与激励活动，并在奖励解锁后及时领取
* Vault 现在总共持有 1,025,000 USDC（增长 2.5%）
* 你的 10,000 枚 `_USDC` 现在可赎回 10,250 USDC
* 你无需进行任何操作

***

## 通过 Ripe Protocol 提升资本效率

核心 Vault 份额可以在 [Ripe Protocol](https://ripe.finance) 中成为高质量抵押品，这会带来更强的资本效率：

1. **存入** 核心 Vault，获得 `_USDC`
2. **把 `_USDC` 作为抵押品** 存入 Ripe 借出稳定币
3. **你的抵押品继续生息**，AI 会在后台持续优化收益
4. **把借出的稳定币继续部署** 到其他用途

你的抵押品会 24/7 持续工作。它不是躺着不动的静态抵押物，而是在你借款的同时继续赚钱。

***

## Amplified Vaults

基于核心 Vault 份额和 Ripe Protocol 的管理型放大策略可带来更高收益，同时内置债务安全机制。

### 工作方式

Amplified Vaults 通过在抵押品之上借款来放大收益，但它有一个关键安全特性：**借入资金始终被限定在美元计价策略中**，以确保 Vault 总能偿还债务。借来的金额也会再次作为额外抵押品存回 Ripe，从而形成两层抵押支持：你的原始资产加上借来的美元资产。

完整流程如下：

1. **你存入** 受支持的基础资产到 Underscore Amplified Vault（目前为 cbBTC 或 USDC）
2. **Vault 把你的资产** 存入对应的核心 Vault（由 AI 优化收益）
3. **Vault 将这些生息份额** 作为抵押品存入 Ripe Protocol
4. **Vault 以该抵押品借出** GREEN（稳定币）
5. **Vault 将 GREEN 兑换为** USDC
6. **Vault 把 USDC** 存入 USDC 核心 Vault（继续赚收益）
7. **Vault 再把这些 USDC 核心 Vault 份额** 作为额外抵押品加入 Ripe

结果是：你的原始资产在生息，而借来的那部分资金也在生息；同时，借来的这部分始终保持在美元计价资产中。

#### 收益测算：Amplified cbBTC

假设你存入价值 100,000 美元的 cbBTC：

| 层级                 | 金额         | 利率   | 年化收益          |
| ------------------ | ---------- | ---- | ------------- |
| cbBTC 在核心 Vault 中  | 100,000 美元 | 0.5% | +500 美元       |
| 从 Ripe 借款（70% LTV） | 70,000 美元  | 3%\* | -2,100 美元     |
| USDC 在核心 Vault 中   | 70,000 美元  | 8%   | +5,600 美元     |
| **净收益**            |            |      | **+4,000 美元** |

*\*本例中的 3% 借款利率反映的是 Ripe 针对 Underscore Vault 的协议级折扣：在标准 6% 借款利率上应用 50% 折扣。该折扣是可配置参数，未来可能调整。*

**综合 APY：4.0%**。对于你原本的 100,000 美元 cbBTC 来说，相比基础 0.5% 收益提升了 8 倍，同时仍保持完整 BTC 敞口。

### 为什么美元计价债务很重要

这种设计可以保护 Vault 免于被清算：

* **借入资金保持为 USDC 或 Savings GREEN**：Vault 不会把借来的资金再兑换成 BTC 或其他波动资产
* **债务始终有覆盖**：即便你的 BTC 抵押品（cbBTC）下跌 50%，借来的美元部分仍保持价值
* **不会形成死亡螺旋**：借来的那部分不会随着价格下跌放大亏损

**示例**：仍然以刚才那笔 100,000 美元的 cbBTC 存款为例：

* Vault 借出 70,000 美元 GREEN（70% LTV），再换成 USDC
* cbBTC 下跌 40% → 你的原始抵押品现在只值 60,000 美元
* 但那 70,000 美元借款部分依然以 USDC 形式在持续生息
* 这些 USDC 同样被作为抵押品存回 Ripe，因此你总共有 60,000 + 70,000 = 130,000 美元抵押品，对应 70,000 美元债务
* 头寸仍然健康，因为借来的部分没有贬值，而且还额外补充了抵押品

这与传统杠杆头寸不同。传统做法会把借来的钱继续买入波动资产，而那样的结构更容易在价格下跌时连环清算。

### AI 在做什么

AI 同时管理收益与风险：

* **抵押品管理**：先把资产存入核心 Vault，再存入 Ripe Protocol
* **策略性借款**：以抵押品借出 GREEN，然后要么兑换成 USDC（如果 DEX 流动性充裕），要么直接作为 Savings GREEN 进行质押。无论哪种方式，借来的部分都会继续生息
* **只保留美元敞口**：借来的资金始终保持在美元计价资产中（USDC 或 GREEN），不会被换成波动资产
* **债务比率监控**：维持可配置的最大杠杆水平
* **自动去杠杆**：当债务比率接近上限时自动降低杠杆

### 风险管理

Amplified Vaults 内置了多层安全机制：

| 控制项        | 作用                  |
| ---------- | ------------------- |
| **仅限美元借款** | 借来的资金保持稳定币敞口        |
| **最大债务比率** | 对杠杆设置硬上限（例如最多 200%） |
| **自动去杠杆**  | 比率接近上限时主动降低头寸       |
| **提现安全**   | 为赎回自动拆解杠杆           |
| **持续监控**   | AI 全天候跟踪健康因子        |

### 示例：Amplified cbBTC Vault

**你存入 1 枚 cbBTC（价值 100,000 美元）**：

```
你的 1 枚 cbBTC
    ↓
cbBTC 核心 Vault（赚取 0.5%）
    ↓
把核心 Vault 份额作为抵押品存入 Ripe
    ↓
借出 70,000 美元 GREEN（70% LTV）→ 兑换成 USDC
    ↓
USDC 核心 Vault（赚取 8%）
    ↓
把 USDC 核心 Vault 份额再存回 Ripe 作为额外抵押品
```

**收益放大效果**：

* 你的 cbBTC 在 cbBTC 核心 Vault 中赚取 0.5% → 每年 +500 美元
* 借款成本按 3%（折扣利率）计算 → 每年 -2,100 美元
* 借来的 70,000 美元在 USDC 核心 Vault 中赚取 8% → 每年 +5,600 美元
* **净收益：4.0%**，相较基础收益约提升 8 倍

**如果 cbBTC 下跌 40%**：

* 你的 cbBTC 抵押品：现值 60,000 美元
* 你的 USDC 抵押品：仍为 70,000 美元
* 总抵押品：130,000 美元，对应 70,000 美元债务
* 头寸仍然健康，没有清算风险

**你的风险敞口**：仅来自原始存入资产（cbBTC）的价格波动。放大策略不会放大你的下行亏损，它只会放大收益。如果 cbBTC 下跌 40%，你的初始价值下跌 40%，与直接持有 cbBTC 相同。借来的美元部分保持原值，不会增加额外的下行风险。

***

## 核心 Vaults 与 Amplified Vaults

| 功能         | **核心 Vaults**               | **Amplified Vaults**            |
| ---------- | --------------------------- | ------------------------------- |
| **收益形态**   | 被动的 AI 管理收益                 | 核心收益加上第二层美元借入收益                 |
| **策略内部借款** | 否                           | 是，通过 Ripe Protocol              |
| **债务敞口**   | 无                           | 具备自动去杠杆机制的受控债务                  |
| **抵押品用法**  | 可选：你可以自己把份额拿去 Ripe 使用       | 已内置在 Vault 策略中                  |
| **最适合**    | 想要被动收益并需要可组合 ERC-4626 份额的用户 | 想保持 BTC 或 USDC 敞口，同时获得额外收益放大的用户 |

***

## 存款与份额

### 如何存入

1. 授权 Vault 合约使用你的代币
2. 调用 `deposit()` 并传入目标金额
3. 在钱包中收到 Vault 份额

**份额价格计算公式**：

```
份额价格 = Vault 总资产 / 已发行总份额
```

首次存入时，1 份额 = 1 单位资产。随着 Vault 持续赚取收益，份额价格会逐步上升。

### 如何理解你的份额

Vault 份额代表你对 Vault 全部资产的按比例所有权：

* **100 份额，价格 1.00 美元** = 你对 Vault 资产拥有 100 美元的索取权
* **Vault 获得 10% 收益** = 份额价格上升到 1.10 美元
* **你的 100 份额现在价值 110 美元** = 你已经捕捉到了收益

你不需要手动领取奖励，也不需要自己做再平衡。你的份额会自动反映 Vault 的整体表现。

### 提取

你可以随时把份额赎回为底层资产：

1. 调用 `redeem()` 或 `withdraw()`，传入你的份额数量
2. AI 会在需要时自动拆解底层头寸
3. 底层资产返回到你的钱包

系统会保留一个小缓冲（2%），以确保即使在拆解头寸时，你也能收到预期金额。

***

## Vault 安全性与控制

### 只允许已批准协议

每个 Vault 都运行在严格边界内，而且这些边界由智能合约强制执行，而不是由公司政策约束：

* **白名单目标地址**：AI 只能把资金存入预先批准的收益协议
* **由注册表管理**：Underscore 治理负责维护已批准协议列表
* **不会向未授权目标存入资金**：AI 从代码层面就无法把资金转到未批准的目标地址，这不是“我们承诺”，而是“代码做不到”

这些规则都写在链上。不会有未授权交易，不会去实验性农场，也不会出现“AI 幻觉”。

### 存款控制

Earn Vaults 还可以实现额外保护：

| 控制项        | 作用                  |
| ---------- | ------------------- |
| **存款上限**   | 限制 Vault 总资产，避免过度集中 |
| **允许列表模式** | 只允许指定地址存款           |
| **暂停存款**   | 必要时暂时停止新增存款         |

### 紧急控制

在极端市场情况下：

* **冻结操作**：治理可暂停全部 Vault 活动
* **暂停提取**：市场压力期间可临时暂停提现（仅治理）
* **资金受保护**：即便冻结，你的份额索取权依然有效

***

## 业绩费

Earn Vaults 只会对利润收取费用，从不对本金收费：

* **费率**：所产生收益的 20%
* **适用对象**：仅利润，不包括存款本金
* **透明追踪**：费用与份额机制分开记录
* **不会突然扣减**：你的提现始终反映真实资产价值

**示例**：

* Vault 赚取了 1,000 美元收益
* 20% 费用 = 200 美元归协议
* 800 美元通过份额价格上升分配给存款人

Underscore 的大部分收入来自这 20% 的 Vault 业绩费。Vault 用户赚钱时，协议才赚钱。100% 的费用收入都用于在公开市场回购 [$RIPE](https://app.ripe.finance/ripe)。

有关费用用途，请参见[协议经济模型](/zh/jing-ji-mo-xing/protocol-economics)。

***

## 核心 Vaults 与可编程钱包

| 功能          | **核心 Vaults**  | **可编程钱包**     |
| ----------- | -------------- | ------------- |
| **所有权**     | 按比例份额（代币）      | 资产完全由你控制      |
| **管理方式**    | 由 AI 管理，基本无需操作 | 由你和你的管理员共同决定  |
| **可定制性**    | 每个 Vault 策略固定  | 可完全自定义        |
| **可组合性**    | 高（标准 ERC-20）   | 较低（资产在钱包内）    |
| **访问门槛**    | 任何人都可存入        | 需要先部署钱包       |
| **可否作为抵押品** | 可以（份额本身就是代币）   | 更复杂           |
| **最适合**     | 被动收益、可组合性      | 主动 DeFi、自定义策略 |

**适合使用核心 Vaults 的情况**：你想要一键式收益，需要可组合或可生息抵押品，或希望在不部署钱包的前提下参与。

**适合使用可编程钱包的情况**：你想保留完整控制权，需要自定义策略、代理执行、支付自动化，或想以精确限制方式委托管理员。

***

## 现实世界中的示例

### 被动收益用户

**Sarah** 手上有 50,000 USDC 闲置。她想赚收益，但没有时间天天盯盘。

**方案**：存入 USDC 核心 Vault

* 立即收到 `_USDC` 代币
* AI 在 Morpho、Aave、Euler 等协议之间持续捕捉收益
* 她还可以把 `_USDC` 作为抵押品放到 Ripe 上，为其他机会借款
* 她的抵押品在借出期间仍继续生息

**结果**：可生息收益加可生息抵押品，全程无需主动管理。

### 金融科技应用集成

**PayFlow** 是一款支付应用，希望让用户余额也能获得收益。

**问题**：从零开始搭建收益基础设施需要大量工程时间和安全审计。

**方案**：直接集成 Underscore 核心 Vaults

* 用户通过 PayFlow 的界面存入
* Vault 负责全部收益优化
* PayFlow 在内部跟踪用户份额
* 标准 ERC4626 接口，集成工作量很小

**结果**：无需自建收益基础设施，也能提供 AI 管理收益。

### 放大收益策略

**Marcus** 想在自己的 BTC 上获得更高收益，但又不想自己管理清算风险。

**方案**：把 1 枚 cbBTC 存入 Amplified cbBTC Vault

* cbBTC 在 cbBTC 核心 Vault 中赚取基础收益
* Vault 通过 Ripe Protocol 以其与 cbBTC 关联的抵押品借出 USDC（70% LTV）
* 借出的 USDC 在 USDC 核心 Vault 中继续赚收益
* 借来的资金始终保持美元计价，不会在 BTC 下跌时放大下行风险
* AI 会自动管理再平衡与债务比率

**结果**：相较基础 BTC 收益约提升 8 倍，同时风险敞口仍只来自 BTC 价格本身。

***

## 常见问题

**我可以随时提现吗？** 可以。提现是即时的。Vault 会根据需要自动拆解底层头寸，并在同一笔交易中完成赎回。

**如果 Vault 亏损了怎么办？** 你的份额会反映 Vault 的真实价值。如果底层资产因市场波动而下跌，份额价格也会下降。业绩费只对利润收取。

**我可以存入哪些资产？** 核心 Vaults 会指定各自的底层资产（USDC、ETH、cbBTC、AERO、RIPE 等）。Amplified Vaults 当前在 Base 上支持以 BTC 和 USDC 为基础的头寸。

**Vault 份额可以转让吗？** 可以。Vault 份额是标准 ERC-20 代币。你可以转账、交易，或在任何接受 ERC-20 的地方把它当作抵押品使用。

**最低存款是多少？** 协议层面没有强制最低值，但 Gas 成本会让极小额存款变得不划算。

***

## 开始使用

准备开始赚取 AI 优化收益了吗？[**打开应用 →**](https://app.underscore.finance/)

* **直接存入**：连接你的钱包并存入核心 Vault 或 Amplified Vault
* **选择适合的形态**：核心 Vaults 用于被动收益，Amplified Vaults 用于借助 Ripe 叠加第二层收益
* **跟踪你的头寸**：你的 Vault 份额会显示在任何兼容 ERC-20 的钱包中
* **作为抵押品使用**：把份额存入 Ripe Protocol，以你的收益头寸借款
* **随时提取**：在需要时把份额赎回为底层资产
* **基于 Vaults 构建应用**：通过[技术文档](https://underscore-1.gitbook.io/developers)进行集成
* **查看实时 Vault 配置**：在 [Params Explorer](https://params.underscore.finance/vaults) 中查看当前参数和地址

如果你想完整掌控自己的 DeFi 策略，也可以探索[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)，配合自定义管理员、支付自动化等能力使用。

***

*存入。赚取。放大。自由组合。*


# 可编程钱包

具备可编程支付和 DeFi 访问能力的代理式钱包，授予执行权，而非托管权

大多数代理只能提出建议。Underscore 让它们真正执行，而且可以使用真实资金，但从不接触你的私钥。

Underscore 可编程钱包是专门为 AI 代理和操作员设计的智能合约钱包，让他们能够在链上规则内执行操作。[管理员](/zh/ke-bian-cheng-qian-bao/managers)定义权限，[收款人](/zh/ke-bian-cheng-qian-bao/payees)处理周期性支出，[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)处理带可选审核延迟的一次性付款。一切都由开源智能合约在链上强制执行。

通过一个地址就能统一访问 20+ 个 DeFi 协议。你可以在严格边界内把操作委托给代理；在资金持续赚取收益的同时自动化付款；也可以在多个钱包之间即时调拨资金。

基于 Base L2 构建，这个钱包把机构级安全性和 24/7 捕捉机会的灵活性结合在一起，无论是让代理自主运行，还是由你亲自管理都适用。

从根本上说，Underscore 可编程钱包提供四个关键组件：

1. **统一协议访问**：通过标准化适配器直接集成主流 DeFi 协议
2. **代理执行层**：[管理员](/zh/ke-bian-cheng-qian-bao/managers)在明确边界内执行策略，无托管、无私钥
3. **支付轨道**：用于周期性支出和一次性批准的可编程支付系统（见[收款人](/zh/ke-bian-cheng-qian-bao/payees)与[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)）
4. **安全层**：时间锁、白名单和细粒度权限共同保护每一项操作

## 一个钱包，连接所有协议

Underscore 通过名为 “Lego” 的标准化适配器连接 DeFi 协议。每个 Lego 都为协议特定操作提供一致接口，从而支持原子化的多协议交易，并优化 Gas 使用。

**你的钱包具备面向未来的能力**：当新的 DeFi 协议上线，或现有协议增加功能时，它们会通过新的 Lego 集成自动开放给你的钱包。无需迁移资金、无需部署新钱包、也无需更新任何内容。只要对应的 Lego 部署完成，你现有的可编程钱包就会立即获得访问能力。

### 收益与借贷协议

**已集成协议**：Morpho、Moonwell、Aave、Euler、Fluid、Compound，以及 Avantis、ExtraFi 等专门化协议

**能力**：

* 存入资产赚取收益
* 自动解仓后提取资金
* 跟踪收益并计算利润
* 领取协议奖励
* 在不同协议之间再平衡

### 交易与 DEX 集成

**已集成 DEX**：Aerodrome、Uniswap、Curve

**能力**：

* 通过智能路由兑换代币（最多 5 跳）
* 自动按比例添加/移除流动性
* 同时支持标准流动性（Uniswap V2 风格）与集中流动性（Uniswap V3+ 风格）
* 管理 NFT 头寸并调整价格区间

### 债务管理

**已集成协议**：[Ripe Protocol](https://ripe.finance)

Ripe Protocol 是 Underscore 的借贷合作方，允许你在不卖出资产的前提下获得流动性。关键优势在于：**Underscore 核心 Vault 份额可以作为抵押品使用**。这意味着你的资产可以一边在 AI 优化策略中持续赚取收益，一边作为抵押品去借款。你不必在“收益”和“流动性”之间做选择，可以同时获得两者。Amplified Vaults 也在 Vault 策略内部沿用同样的模式。

**工作方式**：

1. **存入抵押品**：把资产锁定在 Ripe Protocol 中，其中包括 Underscore 核心 Vault 份额
2. **以抵押品借款**：借出 GREEN（稳定币）或会生息的 sGREEN
3. **继续赚取收益**：如果你使用的是核心 Vault 份额作为抵押品，其底层资产仍会继续赚取优化后的收益
4. **随时还款**：按照你的节奏偿还本金和利息
5. **取回抵押品**：债务清偿后，提回资产

**这为什么重要：**

传统借贷往往迫使你二选一：要么赚收益，要么拿资产做抵押。借助 Underscore + Ripe：

* 先存入核心 Vault，让 AI 优化你的收益
* 把核心 Vault 份额作为抵押品存入 Ripe
* 借出 GREEN/sGREEN 来满足流动性需求
* 你的抵押品在整个过程中都继续赚取收益

**能力**：

* 把任意支持资产作为抵押品存入
* 使用 Underscore 核心 Vault 份额作为可生息抵押品
* 借出 GREEN（稳定币）或 sGREEN（生息型稳定币）
* 用任意接受的代币偿还债务
* 在债务头寸上赚取并领取 RIPE 奖励

**管理员权限**：

* **管理债务**：添加/移除抵押品、借款、还款
* 管理员不能把借出的资金提到外部地址
* 所有操作仍然受标准管理员限制约束

**为什么要借款？**

* 不卖出升值资产就获得流动性
* 抵押品仍然继续赚取收益
* 税务效率更高，贷款本身不是应税事件
* 可用于覆盖短期现金流需求

### 资产转换

**能力**：

* ETH ↔ WETH 的零滑点转换
* 铸造和赎回收据型代币（例如 stETH）
* 处理延迟赎回
* 自动完成协议所需的格式转换

### 奖励与激励

**能力**：

* 在一笔交易中批量领取多个协议的奖励
* 自动把奖励复投到可产生收益的头寸中
* 跟踪跨协议的累计收益

## 批量操作：多步动作，一笔交易

Underscore 的架构允许把复杂的多步骤操作原子化地放进同一笔交易中执行。这既能显著节省 Gas，也能避免“只执行一半”的风险。

### 批量操作示例

**收益再平衡**：

```
1. 从 Aave 提取（较低收益）
2. 存入 Morpho（较高收益）
3. 从两个协议领取奖励
4. 把奖励转换为可继续生息的资产
→ 一笔交易全部完成
```

**复杂建仓**：

```
1. 向 Ripe Protocol 存入抵押品
2. 基于抵押品借款
3. 把借来的资金提供为流动性
4. 再质押 LP 代币赚取额外收益
→ 一键完成整套策略
```

**投资组合再平衡**：

```
1. 从多个池子移除流动性
2. 把资产兑换到目标配置
3. 重新部署到新的头寸中
4. 领取并再投资全部[奖励](rewards.md)
→ 整个再平衡原子化完成
```

## 兑换：交易任意代币

当你通过可编程钱包进行兑换时，系统会在已集成的 DEX 之间寻找最佳路径。

### 兑换如何运作

多跳路由示例：

```
想把 USDC 换成 PEPE？
直接路径可能不存在，或流动性很差。

智能路由会找到：
USDC → ETH → PEPE（2 跳）
或者
USDC → WETH → PEPE（2 跳但价格更优）

系统最多支持 5 跳，以获得更优定价。
```

### 滑点保护

每一次兑换都带有滑点保护：你可以指定自己能接受的最小输出值。如果市场情况变化导致实际收到的更少，交易会自动回滚。

* 钱包默认值：可按每次兑换单独配置
* 管理员限制：管理员会有最大滑点上限（例如最多 1%）
* 故障保护：宁愿回滚，也不会在糟糕价格下继续执行

### 兑换费用

Underscore 会对兑换收取 0.25% 费用。这是在 DEX 自身费用之外的额外费用，DEX 费用仍归流动性提供者所有。

兑换费用是 Underscore 较小的收入来源之一。和所有协议收入一样，这部分收入也会用于在公开市场回购 [$RIPE](https://app.ripe.finance/ripe)。

### 管理员的兑换控制

当管理员执行兑换时，还会附加更多限制：

* 最大滑点百分比
* 每周期最大兑换次数
* 每次兑换的最低美元价值
* 资产限制（哪些代币可以参与兑换）

***

## 提供流动性：赚取交易手续费

你的可编程钱包允许你向去中心化交易所提供流动性，并分得交易手续费。这是 DeFi 中很强大的一类策略：你的资产不只是躺着，而是在为别人撮合交易并持续工作。

### 工作原理

当你提供流动性时，你会把一对代币（比如 USDC 和 ETH）存入交易池。交易者在这两个代币之间交换时会支付手续费，而你会按自己在池中的份额分得相应收益。

**基础示例**：

```
你存入：价值 5,000 美元的 USDC + 价值 5,000 美元的 ETH
池子份额：总流动性的 1%
每日交易量：1,000,000 美元
费率：0.3%
你的日收益：30 美元（0.3% × 100 万 × 1%）
```

### 两类流动性

**简单流动性（Uniswap V2 风格）**

* 按相同价值存入两种代币
* 在整个价格区间内都能赚手续费
* 获得代表份额的 LP 代币
* 支持协议：Aerodrome Classic、Uniswap V2、Curve

**集中流动性（Uniswap V3 风格）**

* 自行选择流动性生效的价格区间
* 当价格处于区间内时，手续费收益更高
* 资金效率更高，但需要持续监控
* 获得的是 NFT 头寸，而不是同质化代币
* 支持协议：Aerodrome Slipstream、Uniswap V3

### 管理员的 LP 权限

拥有 **管理流动性** 权限的管理员可以处理流动性操作：

* 向已批准的池子添加流动性
* 再平衡时移除流动性
* 仍然受所有标准管理员限制约束

### 需要理解的风险

**无常损失**：如果两种代币价格发生显著偏离，你最终持仓价值可能低于单独持有它们时的价值。只有在你提取时，这种损失才真正“落地”。

**智能合约风险**：LP 头寸存在于 DEX 的智能合约中。Underscore 只会集成经过审计且已被市场验证的协议。

***

## 其他钱包功能

### Eject Mode：紧急封锁

如果你怀疑钱包被攻破，或需要立刻限制活动，可以启用 eject mode 进入紧急封锁：

**启用后：**

* 只允许转账和 ETH/WETH 转换
* 不再允许收益、兑换、债务或流动性操作
* 只有钱包所有者可以执行操作
* 所有管理员都会被阻止

**使用场景：**

```
发现可疑活动
    ↓
启用 eject mode（1 笔交易）
    ↓
钱包被锁定为仅支持基础操作
    ↓
安全地把资金转到白名单地址
    ↓
确认安全后再关闭 eject mode
```

Eject mode 是你在紧急情况下的“一键急停”：先限制，再调查。

### [管理员](/zh/ke-bian-cheng-qian-bao/managers)：授予代理执行权，而非托管权

管理员是被授权的操作员，可以是人，也可以是 AI。他们会在你定义好的边界内执行操作。管理员可以交易、优化收益、管理付款，但不能向外部地址提现，也不能超出你的限制。

**使用场景**：

* AI 代理 24/7 做收益优化
* 交易代理支付数据源、算力和推理 API
* 自动化管理债务头寸
* CFO 处理供应商和承包商付款
* 专业交易员管理部分投资组合
* 家庭成员拥有紧急访问能力

[→ 了解更多管理员功能](/zh/ke-bian-cheng-qian-bao/managers)

### [收款人](/zh/ke-bian-cheng-qian-bao/payees)：让代理为所需服务付款

收款人是你的周期性支出层。它们是预先批准的收款对象，只能收取你已经允许的金额。你可以用它们来支付市场数据源、模型提供商、算力供应商、承包商、工资和订阅费用。资金会持续赚取收益，直到付款时再自动转出。

**使用场景**：

* 代理的数据源和推理 API 订阅
* 带周预算的算力供应商付款
* 从生息资金中发放员工工资
* 自动化处理供应商和承包商付款
* 支持拉取支付的订阅服务

[→ 了解更多收款人功能](/zh/ke-bian-cheng-qian-bao/payees)

### [数字支票](/zh/ke-bian-cheng-qian-bao/cheques)：无需盲目信任的一次性支出

数字支票会把普通转账变成可控的付款承诺。小额支出立即清算；较大付款则进入审核延迟，并且在兑现前都可取消。你的资金会一直留在钱包中继续赚取收益，直到实际支付发生。

**使用场景**：

* 代理购买一次性数据集或算力任务
* 向承包商付款，并在对方未交付时取消
* 为大额转账保留审核时间
* 带支付灵活性的一次性供应商发票
* 任何你希望保留“撤销”选项的付款

[→ 了解更多数字支票功能](/zh/ke-bian-cheng-qian-bao/cheques)

### [白名单](/zh/ke-bian-cheng-qian-bao/whitelist)：无限信任

白名单是在安全体系里“打碎紧急玻璃”的最后一层：被加入白名单的地址可以即时、无限额收款，不受延迟或限额约束。时间锁添加可以防止被攻破时被快速植入恶意地址，而即时移除则确保你始终保有控制权。

**使用场景**：

* 作为紧急出金通道的硬件钱包
* 需要即时归集资金的企业金库
* 为分散风险而设置的多钱包策略
* 当你失去访问权时可用于恢复的 Gnosis Safe

[→ 了解更多白名单功能](/zh/ke-bian-cheng-qian-bao/whitelist)

## 架构对比

| 传统多钱包架构       | Underscore 可编程钱包 |
| ------------- | ---------------- |
| 多个界面、多套登录流程   | 单一统一界面           |
| 每个协议都要手动做代币授权 | 预先配置好的协议访问       |
| 钱包之间需要外部转账    | 内部路由，无需来回转账      |
| 手动跟踪收益        | 自动计算利润           |
| 自动化能力有限       | 完整的委托执行能力        |
| 每个钱包单独管理安全性   | 统一的安全模型          |

## 常见问题

### 安全与控制

**这是自托管钱包吗？**\
是。你保有所有者钱包的私钥以及对资产的最终控制权。管理员只能执行你在链上授权的受限动作，永远不会获得托管权或开放式签名能力。

**如果 Underscore 消失了怎么办？** 你的资金仍然安全且可访问。智能合约是不可变的，不依赖 Underscore 的服务器。你仍然可以通过 BaseScan 或任何其他界面直接与钱包交互。 当前部署与协议配置也可以在 [Params Explorer](https://params.underscore.finance/deployments) 中查看。

**我可以迁移到新钱包吗？** 可以。协议内置迁移系统，允许你把资金和配置（管理员、收款人、白名单）一起迁移到新的可编程钱包。如果你想获得新功能或重构自己的配置，这会很有用。

### 费用与收费

**有哪些费用？**

* **Earn Vault 业绩费**：仅对收益利润收取 20%
* **兑换费用**：代币兑换收取 0.25%
* **外部奖励领取**：领取协议奖励（MORPHO、WELL 等）时收取 20%
* **收入用途**：100% 的协议收入都用于在公开市场回购 [$RIPE](https://app.ripe.finance/ripe)
* **以下不收费**：转账、闲置资金、存款、债务操作、提供流动性、ETH/WETH 包装与解包

关于费用如何运作以及最终流向哪里，可查看[协议经济模型](/zh/jing-ji-mo-xing/protocol-economics)。

### 技术设置

**我可以搭配自己现有的钱包使用吗？** 可以。你可以直接用现有钱包（例如 MetaMask）来部署 Underscore 可编程钱包，而这个现有钱包随后就会成为钱包所有者（owner）。

**我可以访问哪些协议？**\
当前已接入 20+ 个协议，包括 Aave、Morpho、Compound（借贷），Ripe Protocol（借款），Uniswap、Curve、Aerodrome（交易）等。新协议会通过 Lego 系统自动接入。

**如果 Base L2 出问题怎么办？** Base 继承了 Ethereum 的安全模型。即便发生极小概率的 L2 异常，也存在既定流程可将资产提回 Ethereum 主网。你的资金始终处于你的控制之下。

***

## 轮到你了

AI 代理需要的不只是 API。它们需要受边界约束的链上执行能力、可编程支付轨道，以及硬性的安全限制。

当你需要让代理或操作员在你设定的规则内进行再平衡、付款、借款、还款和调度资金时，就部署一个可编程钱包。

***

*可编程钱包 + Earn Vaults。你的资金永不休眠。*


# 管理员

授予代理执行权，而非托管权，并把它们限制在你设定的不可突破边界内

大多数代理只能提出建议。Underscore 让它们真正执行，而且可以使用真实资金，但从不接触你的私钥。

管理员是你[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)中的被授权操作员，可以执行策略并处理付款，但永远拿不到完全控制权。你可以设置精确权限，例如“最多交易 50,000 美元的 USDC，但绝不能碰我的 ETH”；也可以按协议限制它们，例如“只允许在 Aave、Morpho、Euler 和 Compound 之间再平衡”；再进一步定义支出上限，例如“每日 10,000 美元、每月 100,000 美元”；还可以加上基于时间的控制，到期后自动失效，并在需要时一键撤销。

让 AI 代理在凌晨 3 点抓住收益峰值。让交易代理自己支付数据源和算力成本。让 CFO 支付供应商发票而无需接触储备金。让交易员在精确边界内管理特定仓位。每一次操作都会在链上按你的规则验证。

## 为什么需要管理员

### 代理问题

AI 代理需要用真实资金去执行交易，再平衡收益仓位、支付数据源费用、购买算力资源。但把私钥或无限制访问权直接交给代理，会带来不可接受的风险。传统 API key 和钱包委托缺乏链上强制执行机制，一次漏洞、一次被利用，可能就全没了。

管理员的作用就是在智能合约强制执行的边界内，把执行权交给代理。代理只能做你授权的事，不多也不少。预算、资产限制、协议范围和到期窗口全都由代码强制执行，而不是依赖政策或承诺。

### 手动管理钱包的问题

如果你单独运营一个[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)，会面临几乎无法兼顾的取舍：

* **24/7 机会**：DeFi 不会睡觉，但你会
* **重复任务**：付款给供应商、[领取奖励](/zh/jing-ji-mo-xing/rewards)、再平衡，这些都会持续耗费时间
* **专业门槛**：复杂策略可能需要你并不具备的经验
* **紧急访问**：如果你突然无法操作，资金就会被锁住

传统解决方案都不理想：

* **共享密钥**：一个密钥被攻破，就可能损失全部资产
* **多签**：速度慢，每笔交易都需要协调
* **托管服务**：你失去控制权，还要支付高额成本

### 管理员方案

管理员通过可编程委托实现精确控制：

* **有限权限**：只授予特定动作，例如借贷、兑换、给[收款人](/zh/ke-bian-cheng-qian-bao/payees)付款等
* **支出上限**：为单笔和周期性金额设置硬性封顶
* **资产限制**：限定管理员能操作哪些代币
* **即时撤销**：一笔交易就能取消权限
* **时间延迟**：对敏感动作增加可选的冷却期

### 两阶段安全检查

每一项管理员操作都会自动经过两轮验证：

**操作前检查：**

* ✓ 这个管理员当前是否仍然有效？
* ✓ 它是否具有执行该具体操作的权限？
* ✓ 它是否可以触碰这项资产？
* ✓ 它是否正在使用被批准的协议？
* ✓ 距离它上次操作是否已经过了足够的时间？

**操作后检查：**

* ✓ 它是否仍在单笔交易上限内？
* ✓ 它是否还在自己的日/周/月预算范围内？
* ✓ 它是否超过了自己的终身总额度？

这两轮检查都会在同一笔交易中原子执行。只要任何一项失败，整笔操作就会回滚。

## 权限：管理员能做什么

权限是你授予管理员的细粒度能力。你可以自由组合这些权限，创建出恰好符合需求的角色配置：比如一个只负责付款给供应商的 CFO，或者一个管理整个 DeFi 策略的 AI。每项权限都是独立的，可以和其他权限一起组合使用。

### 转账与支付操作

| 权限                                                   | 能力                                                                                                                                        | 示例用途        |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| **通用转账**                                             | 向[收款人](/zh/ke-bian-cheng-qian-bao/payees)、[白名单](/zh/ke-bian-cheng-qian-bao/whitelist)地址，或通过[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)发送资产 | 支付月度开销      |
| **创建**[**数字支票**](/zh/ke-bian-cheng-qian-bao/cheques) | 安排一次性付款                                                                                                                                   | 延迟支付供应商     |
| **提议**[**收款人**](/zh/ke-bian-cheng-qian-bao/payees)   | 新增周期性付款对象                                                                                                                                 | 为新承包商办理收款配置 |

### DeFi 操作

| 权限        | 能力            | 示例用途                                      |
| --------- | ------------- | ----------------------------------------- |
| **买入与卖出** | 兑换代币、再平衡投资组合  | 维持 60/40 的 ETH/USDC 配比                    |
| **管理收益**  | 在收益协议中存入/提取   | 在 Morpho 和 Aave 之间再平衡                     |
| **管理债务**  | 处理贷款和抵押品      | 维持 150% 抵押率                               |
| **管理流动性** | 提供/移除 DEX 流动性 | 优化 Uniswap V3 价格区间                        |
| **领取奖励**  | 收割协议激励        | 收集并再投资[挖矿奖励](/zh/jing-ji-mo-xing/rewards) |

### 行政操作

| 权限             | 能力               | 示例用途                                    |
| -------------- | ---------------- | --------------------------------------- |
| **白名单管理**      | 添加/移除已批准地址       | 维护供应商列表                                 |
| **领取协议奖励**     | 领取 Underscore 激励 | 自动领取[平台奖励](/zh/jing-ji-mo-xing/rewards) |
| **领取 Loot 分成** | 收取收益分成           | 最大化[协议收益](/zh/jing-ji-mo-xing/rewards)  |

> **提示：Underscore 中的时间单位** 所有基于时间的设置（延迟、冷却期、周期）都以区块而非现实时间存储。在 Base L2 上，区块间隔约为 2 秒：
>
> * 1 小时 = 1,800 个区块
> * 1 天 = 43,200 个区块
> * 1 周 = 302,400 个区块
>
> 本文中的示例都基于 Base 约 2 秒的区块时间。

## 控制：安全边界

权限定义了管理员能做什么，而控制项则定义了他们能在什么边界内做。这些限制确保即便是你信任的管理员，也无法因失误或恶意行为超出你的风险承受能力或把钱包掏空。每一项管理员操作都必须通过这些安全检查点。

### 财务限制

**单笔交易上限**

* 任意单次交易允许的最大美元价值
* 示例：5,000 美元上限能防止一次性的大额损失

**周期性上限**

* 在重复时间窗口内允许的总美元价值
* 周期长度通过全局设置中的 `managerPeriod` 指定（例如 1 天 = 43,200 个区块）
* 当前周期结束时，上限会自动重置
* 示例：交易操作每天最多 10,000 美元

```
第 1 周：10,000 美元额度中已用 7,000 美元 → 第 2 周：重新获得 10,000 美元
未使用的额度不会滚入下一周期，每个周期都会重新开始
```

**终身上限**

* 管理员整个任期内的累计美元总额上限
* 示例：某个持续一年的 AI 服务，累计上限为 500,000 美元

### 操作控制

**交易冷却期**

* 两次交易之间必须等待的时间
* 以区块计量（例如在 Base 上，1 小时 = 1,800 个区块）
* 防止连续快速交易导致失误或被攻击

**资产限制**

* 把管理员限制在特定代币上（例如只允许稳定币）
* 细粒度控制它能碰哪些资产
* 每个管理员最多可配置 40 种不同资产

**协议限制（Legos）**

* 通过协议 ID 把管理员限制在特定 DeFi 协议上
* 每个协议（Lego = 标准化集成，例如 Aave、Curve）都注册在 LegoBook 中
* 示例：只允许与 Aave 和 Compound 交互
* 每个管理员最多可配置 25 个不同协议

**仅允许已批准的收益协议**

* 限制管理员只能把资金存入预先批准的收益类 Vault 代币
* 防止把资金存进高风险、未审查或未知协议
* 通过协议的 VaultRegistry 白名单进行管理
* 通过 `onlyApprovedYieldOpps` 设置启用

**收款人限制**

* 只允许把资金转给预先批准的地址
* 非常适合只与已知供应商交互的业务场景
* 每个管理员最多可配置 40 个已批准的[收款人](/zh/ke-bian-cheng-qian-bao/payees)

**价格为零则失败**

* 当资产价格为 0 时，自动阻止交易
* 防止预言机故障期间继续交易
* 在价格不可用时防止被操纵

### 兑换控制

系统还提供专门的兑换权限控制，用来防止过度亏损和价格操纵：

| 设置            | 作用              | 示例         |
| ------------- | --------------- | ---------- |
| **最大滑点**      | 限制兑换时可接受的最大价格偏移 | 默认最多 5%    |
| **每周期最大兑换次数** | 限制交易频率          | 默认每天最多 2 次 |
| **要求存在美元价格**  | 两种代币都必须有价格数据    | 防止交易无报价代币  |

**滑点保护如何运作：**

在每次兑换前，系统会根据你的滑点设置计算可接受的最小输出值。如果实际输出低于该阈值，交易会自动回滚。

```
示例：以最多 5% 滑点把 1,000 美元 USDC 换成 ETH
最低可接受值：价值 950 美元的 ETH
如果 DEX 只能返回价值 940 美元的 ETH → 交易回滚
```

这能防止：

* MEV 夹子攻击
* 执行过程中的价格操纵
* 极端市场波动
* 意外的糟糕交易

系统会同时比较全局设置和管理员单独设置，并采用其中更严格的那一项。

### 基于时间的安全控制

**激活延迟**

* 新增管理员后，需要等待一段时间权限才会生效
* 你可以自行设置延迟长度（例如 1 小时、1 天、1 周）
* 给你时间核验新增操作，发现异常时及时取消
* 防止仓促或恶意添加管理员

**激活时长**

* 为管理员设置到期时间
* 例如：30 天（试用）、90 天（季度）、365 天（年度）
* 到期后自动撤销，无需手动处理

### 全局设置与单独设置

Underscore 使用双层配置系统，且始终以更严格的设置为准：

**全局管理员设置**

* 你的钱包中所有管理员的总模板
* 设定任何管理员都不能突破的最大边界
* 包含 `canOwnerManage` 标志，用于决定钱包所有者（owner）是否也受这些限制约束

**单独管理员设置**

* 针对某个管理员的个性化配置
* 可以比全局更严格，但绝不能更宽松
* 某项操作必须同时被全局设置和单独设置允许

```
示例：权限层级
全局：可交易 = 是，单笔最大金额 = 100,000 美元
管理员 A：可交易 = 是，单笔最大金额 = 50,000 美元 → 实际只能到 50,000 美元
管理员 B：可交易 = 否，单笔最大金额 = 200,000 美元 → 实际完全不能交易
```

## 真实使用示例

### 收益优化

**配置**：100,000 美元稳定币，由 YieldMaxAI 代理管理

**权限：**

* 资产：只允许稳定币（USDC、USDT、DAI）
* 协议：只允许 Aave、Morpho、Euler
* 限制：每笔 20,000 美元，6 小时冷却期

**结果：**

* 在凌晨 3 点抓住 Morpho 的 5.2% 收益率
* 切换到 Euler 的 6.1% 促销利率
* 自动领取此前遗漏的 312 美元[奖励/激励](/zh/jing-ji-mo-xing/rewards)
* 每年额外多赚约 3,000 美元收益

### 代理服务付款

**配置**：一个需要实时数据、推理 API 和算力资源的交易代理

**权限：**

* 通用转账：仅允许向已批准的[收款人](/zh/ke-bian-cheng-qian-bao/payees)转账
* 创建[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)：用于一次性购买数据
* 资产：仅 USDC
* 限制：每笔 500 美元，每月 5,000 美元
* 冷却期：两次付款间隔 1 小时

**结果：**

* 代理可以让自己的数据源、推理 API 和 GPU 供应商持续在线
* 3-50 美元的小额数据采购可通过数字支票即时完成
* 所有支出都被跟踪、封顶，并且可随时撤销
* 代理永远没有托管权、私钥或无限访问权

### 企业运营

**配置**：一家全球加密公司，拥有 30+ 名承包商和供应商，由 CFO 担任管理员

**权限：**

* 收款对象：仅限预先批准的承包商和供应商地址
* 限制：每笔支付 2,500 美元，每周 25,000 美元
* 冷却期：两次付款间隔 1 小时
* 资产：仅 USDC

**结果：**

* CFO 可独立处理供应商付款
* 每月减少约 1,750 美元的电汇费用
* 钱包所有者不再被日常付款占用精力
* 投资资金仍然不可触碰

### 家族办公室交易

**配置**：5 名专业交易员分别作为独立管理员

**每位交易员的权限：**

* 资产：ETH、BTC、稳定币
* 协议：仅限主流 DEX
* 限制：每笔 100,000 美元，每位交易员每日上限 500,000 美元
* 时长：按季度签约，3 天激活延迟

**结果：**

* 风险分散到多个交易员之间
* 没有任何单个交易员能够突破亏损边界
* 每位交易员的盈亏都可单独追踪
* 季度末可移除表现不佳者

### 债务管理 AI

**配置**：Ripe Protocol 债务管理 AI 代理

**权限：**

* 管理债务：偿还贷款、补充抵押品
* 管理收益：必要时从 Aave/Morpho 提取资产用于还款
* 限制：每笔 50,000 美元，每日 200,000 美元

**结果：**

* 24/7 维持 150% 抵押率
* 需要时自动提取收益来还款
* 在市场波动时补充了 15,000 美元抵押品
* 在市场下跌 20% 时避免了清算

### 青少年交易教育

**配置**：16 岁的儿子用每月零花钱学习 DeFi

**权限：**

* 买入与卖出：可以在主流代币间兑换
* 管理收益：仅可存入 Aave、Morpho、Euler
* 资产：仅限 ETH、USDC 和前 10 大代币
* 限制：每笔 100 美元，每月上限 500 美元
* 冷却期：两次交易间隔 30 分钟
* 时长：6 个月试用期

**结果：**

* 孩子可以用真金白银学习 DeFi
* 损失被限制在可接受的教育成本范围内
* 无法接触家庭主仓位
* 在 18 岁拥有自己钱包前，先积累实际经验

## 生命周期管理

### 管理员状态

```
已添加 → 等待中 → 生效中 → 已到期
  │         │         │        │
  └─────────┴─────────┴────────┴─→ 可随时移除
            │         │
            │         └─→ 可续期（会重置到期时间）
            │
            └─→ 生效前可取消
```

### 管理层级

**你（钱包所有者）**

* 可添加、更新、移除任意管理员
* 可修改全部设置与限制
* 可延长激活周期
* 始终拥有最终控制权

**管理员**

* 只能移除自己
* 不能修改自己的权限
* 不能添加其他管理员
* 防止权限升级攻击

## 常见问题

**管理员可以添加其他管理员吗？** 不能。只有钱包所有者才能添加新管理员，这能防止权限升级攻击。

**管理员到期后会怎样？** 它会自动失去全部权限。你无需执行任何操作。

**我可以在不移除管理员的情况下调整限制吗？** 可以。你可以随时修改权限、限额以及允许的资产和协议。

**未用完的周期额度会滚到下一期吗？** 不会。每个周期都会以完整额度重新开始，用不完就作废。

## 与其他功能协同工作

### 管理员与收款人

* 管理员可以在自己的限制内，向已批准的[收款人](/zh/ke-bian-cheng-qian-bao/payees)转账
* 你可以进一步加入收款人限制，把管理员转账范围约束在已知地址上
* 这非常适合只能给供应商付款的应付账款角色

### 管理员与数字支票

* 管理员可以在自己的支出限制内创建[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)
* 支票金额会计入管理员的日/周期/终身额度
* 支票自带的时间延迟还会再加一层安全保护

### 管理员与白名单

* 只有在你显式授予白名单管理权限的情况下，管理员才能操作[白名单](/zh/ke-bian-cheng-qian-bao/whitelist)
* 地址一旦进入白名单，向它转账时就会绕过普通的收款人和支票控制
* 白名单适合紧急访问和内部资金路由；管理员、收款人和数字支票则更适合日常运营


# 收款人

让代理为自己所需的服务付款，并在精确限额内完成周期性支付

收款人是预先批准、可从你的[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)收款的地址，而且只能在你控制的精确限制内收款。你可以预先批准市场数据源、模型提供商、算力供应商、承包商、工资发放对象和订阅服务等周期性收款方，并设置单笔上限、周期上限、允许资产和冷却期。你的资金会一直留在 DeFi 中赚取收益，直到真正需要付款的那一刻。

你的交易代理可以凭固定的 USDC 配额，让数据源、推理 API 和 GPU 供应商持续在线。你的 CFO 可以支付供应商，而无需接触公司储备金。员工则可以提取自己准确应得的工资。每一笔付款都要经过你规则的验证，每一分钱都在转出前继续赚取收益。

## 为什么需要收款人

### 代理支付问题

AI 代理要想正常运行，就必须为服务付费：为市场判断支付数据源费用，为决策支付推理 API 费用，为执行支付算力成本。但如果给代理无限制的支出权限，风险是不可接受的，一次漏洞或一次被利用，就可能把钱包掏空。

收款人的作用就是先批准具体收款方，再配上硬性支出上限。你的交易代理可以用固定的 USDC 配额维持数据源和 GPU 供应商在线，但它无法超支、无法添加新收款对象，也无法接触超出预算的资金。代理可以作为[管理员](/zh/ke-bian-cheng-qian-bao/managers)去执行付款，但究竟谁能收钱，只能由你来决定。

### 周期性加密支付的问题

无论对代理还是对人类来说，今天要做规律性的加密支付，通常只有几种糟糕选择：

* **手动转账**：每次都重新输入地址，容易打错，也浪费时间
* **给出完全权限**：共享私钥或授予无限支出权限
* **回到传统银行**：支付电汇费用，放弃 DeFi 收益，还要等待处理

这些方案都不适用于需要可靠、可控自动化的代理、企业或个人。

### 收款人方案

收款人会构建一个经过验证的收款方列表，并附带细粒度控制：

```
传统做法：把信用卡交给供应商 → 他们想什么时候扣、扣多少都可以
Underscore：把供应商加入收款人 → 每月上限 5,000 美元 → 仅限 USDC → 每季度自动到期
```

你的资金会继续留在 DeFi 中赚取收益（例如在 Aave、Morpho、Euler 里），直到付款发生的那一刻。系统只会在真正需要时，自动提取恰好够支付的金额。此外，你所有的 DeFi 活动还会继续获得[奖励](/zh/jing-ji-mo-xing/rewards)。

## 预先批准的收款方，由链上强制执行

### 由所有者控制的收款方列表

**直接由所有者控制**：只有你，也就是[钱包所有者](/zh/ke-bian-cheng-qian-bao/user-wallet)，才能直接添加、确认或放宽收款人配置。管理员可以提议新的收款人，但这些提议会一直处于待处理状态，直到你在配置好的延迟结束后批准。收款人可以自行移除自己，但除了你以外，没有人可以激活收款人或扩大其权限。这一切都由智能合约强制执行，而不是依赖人工流程。

### 防篡改的收款记录

**链上收款人记录**：一旦某个收款人被配置好，它的收款地址和限制都会写入链上。管理员无法偷偷把 “GPU Provider” 换成另一个地址，也无法在未经你批准的前提下扩大额度。

### 管理员可以付款，但不能扩展名单

**权力分离**：管理员可以在配置好的上限内，向已激活的收款人执行付款；但他们不能单方面激活新收款方、提高收款人限额，或把资金路由到未批准的目的地。收款方名单由你掌控，代理和操作员只负责执行已批准的流程。

这就是收款人模型的核心：先批准周期性收款对象，再让付款严格在这些边界内执行。

## 收款人控制与配置

你可以为每个收款人设置完整的控制项，确保付款按你的意图发生。这些控制项能防止超支、避免时序错误，并阻止未经授权的变更。

### 财务限制

#### 双重保护系统

每个收款人都同时支持代币数量和美元价值两套限制：

* **单笔交易上限**：每次付款的最大值（例如 1,000 USDC 或 1,000 美元）
* **周期上限**：每个时间周期内的最大值（例如每月 5,000 USDC 或 5,000 美元）
* **终身上限**：累计总上限（例如 50,000 USDC 或 50,000 美元）

系统永远会采用更严格的限制，从而在价格波动下仍然保护你。

#### 周期配置

* **自定义周期**：以区块为单位设置任意周期（例如在 Base 上，43,200 个区块约等于 1 天）
* **自动重置**：每个周期结束时自动刷新限额，未用完的额度不会滚入下个周期
* **常见设置**：按日、按周、双周、按月、按季度

### 支付控制

#### 交易限制

* **最大交易次数**：限制每个周期最多可支付多少次（例如每月工资只允许 1 笔）
* **冷却期**：两次付款之间的最短时间，避免意外重复支付
* **到期时间**：在设定时间后自动停用收款人（例如承包合同结束日期）

#### 资产限制

你可以精确控制每个收款人能收哪些代币：

* **单一资产**：锁定只能收一个代币（例如工资只允许 USDC）
* **首选资产**：设置默认资产，同时保留一定灵活性
* **任意资产**：接受所有代币（适合交易团队等灵活场景）

### 安全功能

#### 全局设置（钱包级）

* **拉取支付总开关**：统一开启或关闭所有拉取支付
* **自付开关**：允许或阻止向你自己付款
* **默认限制**：新收款人会继承的基础设置

#### 单独覆盖

* **自定义限制**：对特定关系覆盖全局设置
* **拉取权限**：即使全局关闭，也可对单个收款人开启
* **资产白名单**：在全局范围之外进一步限制可付款代币

### 系统限制

* **最多 40 个收款人**：每个钱包的容量上限
* **每个收款人最多 40 种资产**：用于资产限制列表
* **故障保护**：若价格预言机不可用，则自动阻止付款
* **建议保持开启**：否则预言机故障期间可能被利用来掏空钱包
* **仅在以下情况关闭**：纯稳定币操作，且你完全信任 1:1 锚定

价格预言机负责向链上提供真实世界资产价格。系统会在价格数据不可用时阻止付款，从而避免预言机故障期间发生潜在攻击。

### 拉取支付安全

**硬性要求**：如果不设置任何限额，你**无法**启用拉取支付。系统至少要求存在一项上限（单笔或周期上限），从根源上杜绝无限制访问。

## 权限系统

### 谁可以添加收款人

* **钱包所有者（你）**：拥有完整控制权，可添加、确认、修改或移除任意收款人
* **管理员**：可以提议新增收款人（需要钱包所有者在延迟结束后批准）
* **其他人**：无权修改收款人或其限制

### 谁可以执行付款

* **钱包所有者（你）**：可以向任意激活收款人付款，只要在限制范围内
* **管理员**：只能向激活的收款人付款，并同时受管理员和收款人两套限制约束
* **收款人**：如果你显式启用了拉取支付，他们可以自行拉取付款

### 谁可以移除

* **钱包所有者（你）**：可以立即移除任意收款人
* **收款人**：可以移除自己，作为干净退出机制
* **管理员**：不能直接移除收款人

## 生命周期管理

### 激活流程

```
已添加 → 待激活 → 生效中 → 已过期/已移除
          （延迟）   （可使用）
```

### 典型的激活与到期组合

| 使用场景     | 激活延迟 | 自动到期  | 这样配置的原因           |
| -------- | ---- | ----- | ----------------- |
| **新供应商** | 7 天  | 90 天  | 新关系需要更高安全性，并按季度复查 |
| **正式员工** | 3 天  | 365 天 | 适中的安全性，符合年度合同周期   |
| **可信家人** | 1 天  | 永不过期  | 便于紧急使用，且关系长期存在    |
| **订阅服务** | 2 小时 | 30 天  | 快速启用，且与月度计费节奏一致   |

### 管理层级

**钱包所有者（你）**

* 直接添加、更新和移除
* 确认管理员的提议
* 始终拥有完整控制权

[**管理员**](/zh/ke-bian-cheng-qian-bao/managers)：被授权的操作员

* 可在限制内向生效中的收款人付款
* 可以建议新增收款人（仍需你的批准）
* 不能直接激活、移除或放宽收款人
* 非常适合在保留控制权的同时，把日常付款委托出去

**收款人**

* 可以移除自己
* 便于实现干净退出

> **提示：管理员提议需要你批准** 如果管理员提议新增某个收款人，你会看到一条待处理请求。安全延迟结束后，你必须手动确认，收款人才会真正生效。这个双步骤机制可以防止未经授权的添加。

## 拉取支付：可选的由收款方发起的扣款方式

你可以允许收款人直接从你的钱包拉取付款，但始终只能在你预先设定的限额内进行。

### 工作方式

1. 收款人主动发起从你钱包中的提取
2. 智能合约根据所有配置好的限制进行验证
3. 若需要，系统会自动从生息头寸中调度资金
4. 如果一切都在限制内，付款立即执行

### 需要双重开启

```
全局设置：canPull = true  且  收款人设置：canPull = true
                    ↓
              拉取支付已启用
```

### 真实收益

传统订阅支付：

* 每月准备好的 500 美元闲置在那里 = 0 收益

使用拉取支付：

* 每月 500 美元如果持续赚取 5% 收益 = 每年多出 25 美元
* 每年 6,000 美元的订阅总额 = 每年多出 300 美元收益

**安全性**：开启拉取支付的收款人**必须**设有上限，绝不允许无限制访问。

## 真实配置示例

### 代理数据源

```
收款人：市场数据供应商
周期：30 天
限制：每月 200 美元，1 笔交易
允许拉取：是
冷却期：25 天
资产：仅 USDC
结果：代理的数据源可自动持续在线
```

### 代理算力供应商

```
收款人：GPU 算力供应商
周期：7 天
限制：每周 500 美元，每笔最多 50 美元
允许拉取：否（由代理主动付款）
资产：仅 USDC
结果：算力成本受周预算约束，并会自动重置
```

### 代理推理 API

```
收款人：推理 API 提供商
周期：30 天
限制：每月 1,000 美元，最多 50 笔交易
允许拉取：是
冷却期：6 小时
资产：仅 USDC
结果：代理调用推理接口时，服务商可按次拉取付款
```

### 员工工资配置

```
收款人：John Smith - Developer
限制：每两周 5,000 美元，仅 USDC
发薪节奏：每月 1 日和 15 日
结果：从持续生息的资金中自动发放工资
```

### 供应商管理

```
供应商：SupplyCo
周期：7 天
限制：每笔 2,000 美元，每周 8,000 美元，终身 100,000 美元
冷却期：1 小时
资产：任意稳定币
结果：在边界内灵活付款
```

### 家庭支持

```
收款人：上大学的女儿
周期：30 天
限制：每月 2,000 美元，最多分 2 笔
资产：仅 USDC
激活：1 天延迟
结果：生活费自动发放，并且可随时调整
```

### SaaS 订阅

```
服务：分析平台
允许拉取：是
周期：30 天
限制：每月 149 美元，1 笔交易
冷却期：25 天
资产：仅 USDC
结果：再也不会错过付款，同时沉淀资金继续生息
```

## 常见问题

**到期后会怎样？** 收款人会自动停用。在你续期前，付款会被阻止。

**如果我误付了更多金额怎么办？** 不会发生。区块链上的智能合约会强制执行硬性上限，无法发送超过配置值的金额。

**每个员工都需要单独创建收款人吗？** 需要。每个收款人都有独立的上限和跟踪记录。

**配置完成后还能修改限制吗？** 可以。修改会立即生效。

## 完美组合：管理员 + 收款人

**收款人** 定义了哪些周期性对象可以收款。 **管理员**（[管理员](/zh/ke-bian-cheng-qian-bao/managers)）则在自己的权限和预算范围内，负责执行这些已批准的付款流程。

两者结合，形成难以突破的安全结构：

* 你只需验证一次付款地址（把它加入收款人）
* 管理员处理日常运营（只向这些收款人付款）
* 你保留最终控制权（只有你能直接激活或放宽收款人）

这种权力分离意味着，你可以把工作委托出去，但不必把信任也交出去。你的 CFO 可以支付已批准的供应商，却无法添加一个假地址；你的 AI 可以维持已批准服务的在线状态，却无法把资金路由到未知地址。

对于 AI 代理来说，这种分离尤其关键。代理（管理员）可以向预先批准的服务提供商（收款人）付款，但不能新增收款对象，也不能修改支出上限。钱包所有者决定代理可以为哪些服务付款，以及最多能花多少钱，而这一切都由链上规则强制执行，不依赖人工政策。

**了解更多**：查看[管理员](/zh/ke-bian-cheng-qian-bao/managers)如何自动化你的付款流程。

## 相关功能

* [**数字支票**](/zh/ke-bian-cheng-qian-bao/cheques)：带时间延迟和取消能力的一次性付款
* [**管理员**](/zh/ke-bian-cheng-qian-bao/managers)：学习如何把付款任务委托给 AI 或团队成员
* [**白名单**](/zh/ke-bian-cheng-qian-bao/whitelist)：为你最信任的地址配置即时、无限额转账
* [**可编程钱包**](/zh/ke-bian-cheng-qian-bao/user-wallet)：了解你的代理式钱包及其全部能力


# 数字支票

无需盲目信任的一次性支出，可取消付款，并带有审核延迟

数字支票是一种带时间锁的付款承诺，在兑现之前控制权始终在你手里。当代理需要向新的交易对手付款时，数字支票会把一次普通转账变成可控的付款承诺。小额支出可以立即清算；较大金额会进入审核延迟，并且在兑现之前始终可以取消。你的资金会一直留在钱包中继续赚取收益，直到真正被领取的那一刻。

你的代理可以即时买下一个 3 美元的数据集。一个 5,000 美元的算力任务则会进入你可取消的审核窗口。向承包商付款也会天然带有审查时间。不需要预先批准对方地址，你可以向任意地址开具支票；在对方兑现前，你都可以取消。对双方来说，所有状态都在链上完全透明。

## 为什么需要数字支票

### 即时加密支付的问题

传统加密转账在你点击发送的瞬间就是不可逆的。没有宽限期，没有反悔空间。这会给很多本来正常的交易带来不必要的风险，例如：

* 你需要在放款前核验交付结果
* 大额金额需要额外的安全措施
* 付款时点需要和业务流程对齐
* 地址或金额填错后，必须能够纠正

### 为什么代理需要支票

对于 AI 代理来说，数字支票提供了一种受控的一次性支出方式。与[收款人](/zh/ke-bian-cheng-qian-bao/payees)不同，收款人适合向已知对象进行周期性付款；而数字支票适合向新交易对手进行临时采购，例如买一个数据集、支付一次性分析费用，或购买临时算力。小额采购立刻清算，较大采购则会进入审核窗口，若你发现异常即可取消。

### 数字支票方案

数字支票将“授权付款”和“实际执行”拆开：

* **现在开票，稍后付款**：先创建付款承诺，再按你的条件执行
* **在兑现前都可取消**：直到资金真正转出前，你都保留控制权
* **自动安全延迟**：大额付款会自带审核期
* **保留收益**：资金在支付前一直留在钱包里继续赚取收益，并且还可能获得[协议奖励](/zh/jing-ji-mo-xing/rewards)
* **一次性，简洁高效**：无需管理周期计划，非常适合单笔付款

## 四阶段生命周期

```
创建 → 时间锁 → 激活 → 完成
  │       │        │      │
  └───────┴────────┴──────┴─→ 在实际支付前都可取消
```

### 开具（创建）

就像填写纸质支票一样，你需要指定收款方和金额。系统会在这一刻记录对应的美元价值，就像是在支票上写下当天日期。此时并不会有资金移动；你只是做出一项付款承诺。

### 设定日期（时间锁）

还记得远期支票吗？我们的安全延迟就是类似机制：

* 大额付款会自动“延期生效”以保护你
* 你也可以为未来付款自定义日期
* 资金会继续留在你的账户里生息，就像银行里的存款一样

### 可以兑现（激活）

支票一旦生效，就可以由以下角色兑现：

* 你自己决定立即处理
* 你授权的[管理员](/zh/ke-bian-cheng-qian-bao/managers)代为处理
* 收款人自己领取（前提是你显式启用了此功能）

### 已清算或作废（完成）

和实体支票一样，最终结果只会是两种：

* **已清算**：资金已成功转给收款人
* **已作废**：过期未兑现，或已被你取消

## 智能安全功能

### 自动美元阈值

你可以设置一个统一的延迟阈值（例如 1,000 美元）：

* 低于阈值：支票可立即生效
* 高于阈值：自动应用延迟

> **注意**：不能为已加入[白名单](/zh/ke-bian-cheng-qian-bao/whitelist)的地址创建支票。如果某个地址已经值得你加入白名单，那就直接使用[白名单的即时无限额转账](/zh/ke-bian-cheng-qian-bao/whitelist)。数字支票适用于那些仍然需要付款控制的地址。

示例：

* 500 美元付款 → 无需延迟
* 5,000 美元付款 → 自动进入安全延迟

### 时间控制

* **高额延迟**：高价值支票需要等待多久（例如 3-7 天）
* **默认过期时间**：支票保持有效的时长（例如 30 天）
* **自定义时序**：可按单张支票覆盖默认设置

时间以区块计量（在 Base L2 上，约 2 秒一个区块，约 43,200 个区块为 1 天）。

## 财务控制

你可以设置多种控制项和限制，让数字支票完全按照你的需求运作。这些控制项帮助你管理风险、避免失误，并确保对付款操作始终保持可见性。无论你是在管理个人财务，还是处理企业供应商付款，都可以按自己的场景和风险偏好进行配置。

### 创建限制

* **最大活跃支票数**：允许同时存在多少张未支付支票（例如 20 张）
* **单张最大金额**：单张支票可设置的最高金额（例如 50,000 美元）
* **周期创建上限**：某个周期内最多可创建多少金额（例如每月 100,000 美元）

### 支付限制

* **周期支付上限**：某一周期内最多可兑现多少金额（例如每周 50,000 美元）
* **支付冷却期**：两次支付之间的最短时间（例如 10 分钟）

### 资产限制

你可以把支票限制在特定代币内：

* 仅限稳定币，适合保守型运营
* 允许任意代币，适合灵活的业务场景
* 单一资产，便于会计核算

## 权限系统

### 谁可以创建

* **钱包所有者**：始终可以创建任意支票
* **管理员**：只有在全局开启且被单独授权时才能创建

### 支付方式

* **推送支付**：由你或管理员执行
* **拉取支付**：由收款人自行领取（必须显式启用）

### 谁可以取消

* **钱包所有者**：任何支票都可以在支付前随时取消
* **安全控制**：只保留紧急取消权限

## 真实配置示例

### 代理购买数据集

```
金额：3 USDC
解锁：立即（低于阈值）
过期：24 小时
可拉取：是
结果：代理即时买下数据集，无需人工审核
```

### 代理支付一次性服务

```
金额：500 USDC
解锁：立即（低于 1,000 美元阈值）
过期：7 天
可拉取：是
结果：代理支付一次性算力任务，服务商可在准备好时领取
```

### 代理进行大额采购（带审核）

```
金额：5,000 USDC
解锁：3 天（超过阈值后自动应用）
过期：30 天
审核：钱包所有者可在 3 天延迟期内取消异常采购
结果：大额代理支出获得人工审核窗口
```

### 社交支付

```
金额：30 USDC
解锁：立即（低于阈值）
过期：7 天
可拉取：是
结果：朋友可以在方便时把午餐钱领走
```

### 自由职业者发票

```
金额：3,000 USDC
解锁：3 天（高于 1,000 美元阈值后自动延迟）
过期：30 天
可拉取：是
结果：客户表达付款承诺，接单方自行决定何时领取
```

### 月租

```
金额：2,500 USDC
创建时间：每月 25 日
解锁：次月 1 日
可拉取：是
结果：房东按时收款，而你仍保有控制权
```

### 高价值合同

```
金额：50,000 USDC
解锁：7 天（高额延迟）
过期：45 天
审核收益：有时间验证交付结果
延迟期间赚取的收益：约 48 美元*
```

\*收益会随实时市场利率变化

## 收款人体验

数字支票对发送方足够安全，对收款人也同样足够简单。收款人能够在链上完整验证支票是否存在以及具体条款，然后再决定是否提供商品或服务。一旦安全延迟结束（如果有），收款人就可以在有效期内按自己的时间安排领取付款。

这种模式能建立双方信任：收款人能看到你确实承诺付款，而你在出现问题时仍保有取消能力。区块链确保双方始终能清晰看到付款状态，从而消除传统付款方式常见的不确定性。

## 高级功能

### [管理员](/zh/ke-bian-cheng-qian-bao/managers)创建的支票

你可以让 AI 或团队成员在你的规则内创建支票。具体可参考如何[为管理员配置支票权限](/zh/ke-bian-cheng-qian-bao/managers)：

1. [管理员](/zh/ke-bian-cheng-qian-bao/managers)基于已批准的发票创建支票
2. 时间锁会自动生效
3. 你在延迟期间进行审核
4. 取消或让它继续生效

### 智能资金来源

与自动化付款系统一样，数字支票也会在需要时智能调度资金来源：

* 先检查可用余额
* 如有需要，再自动从 Aave、Morpho 等协议中提取
* 在一笔交易中完成整笔付款

## 常见问题

**如果我填错了金额怎么办？** 在支票被兑现前取消它，然后重新创建一张新的。

**收款人能看到待处理中的支票吗？** 可以。支票从创建开始就在链上完全透明。

**我能修改一张支票吗？** 不能，但你可以取消后按新条款重建。

**我可以给白名单地址开支票吗？** 不可以。对白名单地址请直接使用[白名单](/zh/ke-bian-cheng-qian-bao/whitelist)进行即时付款。数字支票适用于那些尚未加入白名单、仍然需要付款控制的对象。

**支票过期后会发生什么？** 就像银行里的作废支票一样，过期后它会自动失效。资金从未离开你的钱包，因此会立刻重新可用于其他用途。你无需执行任何额外操作。

**支票金额或数量有限制吗？**\
有，为了安全。你可以设置单张支票的最大金额，也可以限制总活跃支票数量。这些保护措施可以防止意外超额承诺，同时保留足够的灵活性。

**我的**[**管理员**](/zh/ke-bian-cheng-qian-bao/managers)**可以替我处理支票吗？** 可以，而且这非常有用。你可以授权[钱包管理员](/zh/ke-bian-cheng-qian-bao/managers)在你设定的限额内创建和取消支票。这很适合由 CFO 处理供应商付款的企业，或希望财务顾问协助管理大额转账的个人。关键在于，管理员永远只能在你预设的边界内运作，不能超出支出上限，也不能修改你的安全设置。具体可参考[使用管理员管理钱包](/zh/ke-bian-cheng-qian-bao/managers)。

## 相关功能

* [**收款人**](/zh/ke-bian-cheng-qian-bao/payees)：为常规支出设置自动化周期性付款
* [**管理员**](/zh/ke-bian-cheng-qian-bao/managers)：学习如何将付款任务委托给 AI 或团队成员
* [**白名单**](/zh/ke-bian-cheng-qian-bao/whitelist)：为最信任的地址配置即时、无限额转账
* [**可编程钱包**](/zh/ke-bian-cheng-qian-bao/user-wallet)：了解你的代理式钱包及其全部能力


# 白名单

通过时间锁安全机制，为你最信任的地址提供即时、无限额转账

白名单允许特定地址从你的[可编程钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)接收无限额转账，无消费上限、无延迟、无任何限制。它非常适合你的硬件钱包、冷存储、其他可编程钱包或紧急联系人。市场变化时可瞬间转走数百万资金。若遇到账户被攻破，可在数秒内撤离资产。多钱包策略也能以机会出现的速度执行。

添加地址时会经过时间锁安全延迟（可配置，通常为 3-7 天），以防止未经授权的添加。若某个地址发生风险，可立即移除。每一笔白名单转账都会即时执行且不受限制，这是你最高等级的信任设置。

## 为什么需要白名单

### 三类收款对象的限制问题

你的[钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)要求每个收款地址必须属于以下三类之一：[收款人](/zh/ke-bian-cheng-qian-bao/payees)（有限额）、通过[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)支付（有延迟），或在白名单中。这能确保安全，但也会带来摩擦：

* **收款人**：非常适合周期性付款，但限额会限制大额转账
* **数字支票**：很适合一次性付款，但延迟会错过时间敏感型机会
* **缺失的选项**：如果是你自己的钱包，需要即时且无限额的访问怎么办？

当 AI 代理发现套利机会，或 DAO 需要进行金库归集时，[收款人](/zh/ke-bian-cheng-qian-bao/payees)的限额和[数字支票](/zh/ke-bian-cheng-qian-bao/cheques)的延迟，都会直接吞掉利润空间。

### 白名单方案

白名单通过为“绝对信任”的地址提供特殊类别，补全了整个支付体系：

* **你的其他**[**可编程钱包**](/zh/ke-bian-cheng-qian-bao/user-wallet)：在你自己的账户之间即时转移数百万资金
* **硬件钱包**：当风险出现时，快速把资金转入更安全的地址
* **企业资金库**：为业务运营提供即时归集能力
* **时间锁安全**：添加需要等待期，移除立即生效
* **兼容管理员**：你可以委托白名单管理，而不需要把资金控制权交出去

## 白名单如何运作

### 支付层级

你的[钱包](/zh/ke-bian-cheng-qian-bao/user-wallet)识别三类支付接收方：

```
[收款人](payees.md) → 带配置上限的周期性付款
[数字支票](cheques.md) → 带延迟与取消能力的一次性付款
白名单 → 即时无限额转账
```

只有这三类地址中的一种，才能从你的钱包接收付款。

### 交易流程

```
你发起转账
        ↓
收款方是否在白名单中？
        ↓
    ┌───┴───┐
    │       │
   是       否
    │       │
    ↓       ↓
立即执行转账  是否为收款人或数字支票？
            ↓
        ┌───┴───┐
        │       │
       是       否
        │       │
        ↓       ↓
    应用限额    交易
    后继续      被阻止
```

## 安全功能

### 时间锁添加

添加白名单地址会经过一个由你控制的安全延迟：

```
提议 → 时间锁 → 确认 → 激活
第 1 天   你设定的时长  已就绪   直到被移除
```

**这是你对抗钱包被攻破时的终极防线。**

每个可编程钱包都有一个钱包所有者（owner），也就是拥有完全控制权的外部钱包（EOA 或硬件钱包）。如果攻击者攻破了这个所有者钱包，时间锁会为你争取关键的防御窗口。

即便攻击者完全控制了你的所有者钱包，也**无法立刻**把你的可编程钱包掏空，原因如下：

1. **攻击者尝试把自己的地址加入白名单** → 进入时间锁期（例如 7 天）
2. **你看到这个待处理添加** → 你有几天时间应对，而不是几分钟
3. **你立即取消这次恶意添加** → 攻击计划失败
4. **你把全部资金转移到已预先加入白名单的冷存储** → 资金安全

攻击者被迫暴露意图，而你仍掌握完整主动权。他们无法瞬间加入自己的地址，无法加速时间锁，也无法阻止你把资产转移到你已信任的白名单地址。

这段时间延迟能把一次原本可能成功的攻击，变成一次失败的尝试，让你拥有保护资产的关键窗口。

### 可配置安全延迟

延迟时长由你钱包中的 `timeLock` 设置控制，以区块数为单位。你可以按自己的偏好设置任意长度：更短意味着更便利，更长意味着更安全。

这个延迟适用于钱包里所有安全关键操作，而不仅仅是白名单添加。

### 即时移除

与添加不同，移除白名单地址会立刻生效，这能在分秒必争时保护你。

## 权限系统

### 所有者（你）

你对所有白名单操作拥有完全权限：

* 添加、确认、取消和移除地址
* 对你的控制没有任何限制
* 覆盖其他所有权限
* 把[奖励](/zh/jing-ji-mo-xing/rewards)发送到任意白名单钱包

### [管理员](/zh/ke-bian-cheng-qian-bao/managers)

在被授予权限的前提下，管理员可拥有以下白名单能力：

* **提议**：建议新增地址，等待你批准
* **确认**：在安全延迟结束后完成添加
* **取消**：在地址激活前停止待处理添加
* **移除**：删除已存在的白名单地址

每项权限都必须单独授予。管理员只会获得你明确给出的白名单管理能力。

### 额外安全特性

* **所有者变更保护**：一旦所有权发生变化，所有待处理添加都会自动取消
* **不可创建数字支票**：白名单地址不能接收数字支票
* **地址校验**：不能把空地址、钱包自身或配置合约加入白名单

## 真实使用场景

### 多钱包策略

**保守 + 激进拆分**

* 保守钱包：稳定币收益、供应商付款
* 激进钱包：AI 交易代理、DeFi 策略
* 即时再平衡：一旦机会出现，可在不同策略间快速调动大量资金

把这些钱包互相加入白名单后，你的 AI 一旦发现 alpha，就能即时部署资本。

**应对安全威胁**

* 活跃钱包：日常操作更多，和外部交互频繁
* 安全冷存储：最高安全级别，很少直接操作
* 即时撤离：威胁出现时立刻转出全部余额

当你怀疑钱包遭遇入侵，或面对现实世界的胁迫攻击时，每一秒都很重要。把你的安全存储加入白名单，就能即时撤离资金。

### DAO 与企业资金库

**多签操作**

* 运营钱包 → 主金库：每日收入归集
* 主金库 → 运营钱包：快速拨付抓住机会
* 紧急转移：立即响应治理决策

**部门管理**

* 市场部钱包需要紧急活动经费
* 开发钱包需要马上支付承包商
* 投资钱包发现时间敏感型机会

不同部门的钱包彼此加入白名单，就能在不牺牲安全性的前提下提升运营效率。

### AI 代理操作

**自动化策略执行**

* AI 识别出跨协议套利机会
* 需要从你的收益钱包中即时调度资金
* 机会窗口往往不到 60 秒

没有白名单：支票延迟或收款人限额会直接杀死交易 有了白名单：你的 AI 可以按市场速度执行

## 常见问题

**我能加快时间锁吗？**\
不能。延迟是绝对生效的，这是安全性的基础。请提前规划白名单添加。

**如果我失去了对白名单地址的控制怎么办？** 立即移除。被攻破的白名单地址是你风险最高的入口。

**被移除的地址还能再加回来吗？** 可以，但需要重新走完整流程。

**如果我尝试向未批准地址转账，会发生什么？** 交易会在任何资金离开钱包之前被阻止。

**白名单和我的每日转账上限如何交互？** 白名单地址会绕过**所有**限制，包括每日、每周和终身上限。这就是为什么你只应该把完全信任的地址加入白名单。

## 相关功能

* [**收款人**](/zh/ke-bian-cheng-qian-bao/payees)：为日常固定支出设置自动化付款
* [**数字支票**](/zh/ke-bian-cheng-qian-bao/cheques)：带时间延迟和取消能力的一次性付款
* [**管理员**](/zh/ke-bian-cheng-qian-bao/managers)：学习如何把付款任务委托给 AI 或团队成员
* [**可编程钱包**](/zh/ke-bian-cheng-qian-bao/user-wallet)：了解你的代理式钱包及其全部能力


# 奖励

通过收益加成和存款奖励赚取 RIPE 代币

只要使用 Underscore，就能赚取 [Ripe Protocol](https://ripe.finance) 的治理代币 RIPE。你创造的收益越多、持有的资产越久，获得的 RIPE 就越多。

**两种获取方式：**

1. **收益加成**：你的收益利润可获得 1:1 的 RIPE 匹配
2. **存款奖励**：根据持仓金额和持有时长赚取 RIPE

邀请朋友也能在他们获得收益时，为你带来额外的 RIPE。

***

## 收益加成（1:1 RIPE 匹配）

当你实现收益利润时，还会额外获得 RIPE 代币：

* **1:1 匹配**：每赚取 1 美元收益，就获得价值 1 美元的 RIPE
* 在提取收益时自动发放
* 仅适用于收益策略，不适用于兑换或奖励领取
* 需要分发器中有可用的 RIPE 余额（先到先得）

**示例**：你提取了 1,000 美元的收益利润

* 你保留 1,000 美元利润（以收益资产计）
* 你还会收到约 1,000 美元价值的 RIPE 代币

### 推荐加成

邀请朋友使用 Underscore，当他们获利时，你也会获得 RIPE：

* **1:1 匹配**：你邀请的用户每赚取 1 美元收益，你就获得价值 1 美元的 RIPE
* 你的朋友仍然可以拿到他们自己的完整 1:1 加成
* 同一次收益事件会让双方同时受益

**示例**：你的朋友实现了 1,000 美元收益利润

* 朋友保留 1,000 美元利润，并获得约 1,000 美元的 RIPE 加成
* 你因推荐他们，也会获得约 1,000 美元的 RIPE 加成

***

## 存款奖励

只需在你的 [钱包](/zh/ke-bian-cheng-qian-bao/user-wallet) 中持有资产，也能赚取 RIPE：

```
积分 = 美元价值 × 持有区块数
你的份额 = 你的积分 / 全局总积分
```

**运作方式：**

1. 在你的 [钱包](/zh/ke-bian-cheng-qian-bao/user-wallet) 中持有资产
2. 随时间累积积分
3. 领取你在 RIPE 奖励池中的按比例份额

**示例**：

* 持有 10,000 美元资产 2 周
* 协议总积分 = 3,024，你的积分 = 60.48（占 2%）
* 奖励池中有价值 5,000 美元的 RIPE → 你可领取约 100 美元的 RIPE

***

## RIPE 代币详情

RIPE 是 [Ripe Protocol](https://ripe.finance) 的治理代币，而 Ripe Protocol 则是 Underscore 集成的借贷协议。你的 RIPE 可以：

* **持有**，等待潜在升值
* **质押** 到 Ripe 治理中，获取投票权和额外奖励
* 在支持的交易所上**交易**

### 自动质押

目前，**80% 的 RIPE 奖励会自动质押** 到 Ripe 的治理金库中，锁定期为 180 天。剩余 20% 会直接发送到你的钱包。这让你无需额外交易，就能立刻获得质押收益。

***

## 费用结构

Underscore 会对部分活动收取小额费用：

| 活动        | 费用    | 适用对象                               |
| --------- | ----- | ---------------------------------- |
| 兑换        | 0.25% | 交易金额                               |
| 外部奖励      | 20%   | 协议奖励领取（MORPHO、WELL 等）              |
| Vault 业绩费 | 20%   | 核心 Vaults 和 Amplified Vaults 的收益利润 |

**以下不收费**：转账、存款、闲置资金或本金。

***

## 未来：大使收益分成

除了上文所述的 RIPE 收益加成外，大使未来还可能按原资产形式获得一部分费用分成，也就是以产生该费用的同一资产支付。该功能已经存在于协议中，但当前收益分成比例设置为 0%。如果未来启用大使收益分成，会先扣除这部分，再把剩余协议收入分配给 [$RIPE](https://app.ripe.finance/ripe) 回购。

***

## 常见问题

**Q: 何时可以领取？** A: 奖励一旦累积即可领取，但仍受冷却期限制。如果已获授权，[管理员](/zh/ke-bian-cheng-qian-bao/managers) 可以代你领取。

**Q: 奖励会丢失吗？** A: 不会。奖励会持续累积，直到你领取为止，但仍受合约余额限制。

**Q: 加成一定会发放吗？** A: 只有在分发器拥有足够 RIPE 余额时才会发放，先到先得。

**Q: 存款积分如何计算？** A: 积分 = 存款价值 × 时间。存得越多、持有越久，积分越多，在奖励池中的份额也越大。

**Q: 我的 RIPE 会自动质押吗？** A: 会。80% 会自动质押到 Ripe 治理中，锁定 180 天；20% 直接进入你的钱包。

***

## 核心结论

赚收益，得 RIPE。持有资产，得 RIPE。邀请朋友，他们获利时你也能得 RIPE。

你的每一笔 DeFi 活动，都会直接转化为代币奖励。

***

## 下一步

* [**存入 Earn Vaults**](/zh/earn-vaults/vaults)：选择核心 Vaults 获取直接收益，或选择 Amplified Vaults 获取第二层收益，再叠加 RIPE 加成
* [**部署你的钱包**](/zh/ke-bian-cheng-qian-bao/user-wallet)：开始积累存款积分
* [**添加管理员**](/zh/ke-bian-cheng-qian-bao/managers)：自动化奖励领取
* [**设置白名单**](/zh/ke-bian-cheng-qian-bao/whitelist)：将奖励导向任何可信钱包


# 协议经济模型

Underscore 如何产生收入，以及这些收入会流向哪里

Underscore 通过对创造价值的活动收取费用来产生收入。其中大部分来自对 Vault 利润收取的 20% 业绩费，因此 Vault 用户赚钱时，协议才赚钱。100% 的协议收入都用于在公开市场回购 [$RIPE](https://app.ripe.finance/ripe)。

***

## 收入来源

### Vault 业绩费（主要来源）

协议收入的最大来源是 [Underscore Earn Vaults](/zh/earn-vaults/vaults)。其中包括核心 Vaults 和 Amplified Vaults。

* **费率**：收益利润的 20%
* **适用对象**：仅针对利润，绝不针对本金
* **收取时点**：当收益被实现时

**示例**：某个 Vault 为所有存款人合计创造了 100,000 美元收益

* 20,000 美元 → 协议收入
* 80,000 美元 → 通过份额价格上升分配给存款人

Vault 业绩费会随着协议 TVL 和收益表现一起增长，因此随着 Underscore 扩大规模，这将成为最主要的收入来源。

### 兑换费用

通过 Underscore 钱包执行代币兑换时收取。

* **费率**：交易金额的 0.25%
* **适用对象**：所有兑换，包括稳定币对

**示例**：10,000 美元兑换 → 25 美元费用

### 外部奖励领取费用

从集成协议领取奖励（MORPHO、WELL、AERO 等）时收取。

* **费率**：已领取奖励的 20%
* **适用对象**：仅外部协议激励

**示例**：领取价值 200 美元的 MORPHO 奖励 → 40 美元费用

***

## 哪些是免费的

以下操作不收费：

* 钱包之间转账
* 存款和提现
* 闲置资金
* 债务操作（借款/还款）
* 提供流动性
* ETH/WETH 包装与解包

***

## 收入分配：回购 $RIPE

100% 的协议收入都用于在公开市场回购 [$RIPE](https://app.ripe.finance/ripe)。

随着 Underscore 使用量增长，回购需求也会随之扩大，并回流到整个生态。

**链上验证**：当前费用参数可在 [Params Explorer](https://params.underscore.finance/protocol) 中查看。

***

## 总结

| 收入来源      | 费率        | 相对规模         |
| --------- | --------- | ------------ |
| Vault 业绩费 | 收益的 20%   | 最大（随 TVL 扩大） |
| 兑换费用      | 金额的 0.25% | 中等           |
| 外部奖励      | 领取金额的 20% | 较小           |

**100% 的收入 → 在公开市场回购** [**$RIPE**](https://app.ripe.finance/ripe)


# Underscore Protocol

당신의 돈은 잠들지 않습니다

하나의 프로토콜. 두 가지 제품.

1. [**Earn Vaults**](/ko/earn-vaults/vaults) — 같은 지분 기반 구조를 바탕으로 두 가지 수익 프로필을 제공합니다. 핵심 Vaults는 패시브 AI 관리형 수익을, Amplified Vaults는 Ripe 기반 수익 증폭을 제공합니다.
2. [**프로그래머블 월렛**](/ko/undefined-1/user-wallet) — AI 에이전트와 운영자가 사용자가 정한 규칙 안에서 결제하고, 리밸런싱하고, 자금을 이동하는 프로그래머블 월렛입니다. 수탁 없음. 프라이빗 키 공유 없음. 무제한 접근 없음.

당신이 쉬는 동안에도 자금은 계속 수익을 냅니다. 일일이 관리할 필요도 없고, 기회를 놓칠 일도 없습니다.

***

## Earn Vaults

Underscore Earn Vaults는 두 가지 형태로 제공됩니다.

* **핵심 Vaults** — 표준 ERC-4626 지분 토큰으로 감싼 AI 관리형 패시브 수익
* **Amplified Vaults** — 핵심 Vault 지분 토큰 위에 구축되며, Ripe를 사용해 두 번째 수익 레이어를 더하는 구조

자산을 예치하고 Earn Vault 지분 토큰을 받으면, 전략은 그 아래에서 자동으로 작동합니다.

* **조합 가능성** — Earn Vault 지분 토큰은 DeFi 어디서든 활용할 수 있습니다. 거래하고, 브리지하고, 담보로 쓸 수 있습니다
* **수익 창출형 담보** — 담보가 계속 수익을 내는 동안 Ripe에서 대출할 수 있습니다
* **확장성** — 10만 명의 사용자가 하나의 전략을 공유합니다. AI는 한 번만 리밸런싱하고, 모두가 그 혜택을 받습니다

**이런 분께 적합합니다:** 패시브 수익을 원하는 사용자, 수익 창출형 담보가 필요한 프로토콜, 기본 수익 또는 증폭 수익 기능을 추가하려는 핀테크 앱

**→ 자세히 보기:** [**Earn Vaults: 핵심 Vaults와 Amplified Vaults**](/ko/earn-vaults/vaults)

***

## 프로그래머블 월렛: 에이전트를 위한 돈

대부분의 에이전트는 추천만 할 수 있습니다. Underscore는 한 걸음 더 나아가, 프라이빗 키를 쥐여주지 않고도 실제 자금으로 실행하게 만듭니다.

프로그래머블 월렛은 AI 에이전트와 운영자에게 엄격한 경계 안에서 온체인 실행 권한을 부여합니다. [매니저](/ko/undefined-1/managers)는 권한을 정의하고, [수취인](/ko/undefined-1/payees)은 반복 지출을 처리하며, [디지털 수표](/ko/undefined-1/cheques)는 선택적 검토 지연이 있는 일회성 결제를 처리합니다. 모든 것은 스마트 컨트랙트에 의해 온체인에서 강제됩니다.

### [매니저: 에이전트에게 실행 권한을 부여하되, 수탁 권한은 주지 않습니다](/ko/undefined-1/managers)

에이전트가 수익 관리, 스왑, 대출, 상환, 보상 청구, 결제를 수행하도록 승인할 수 있습니다. 자산, 프로토콜, 예산, 쿨다운(cooldown), 만료 조건별로 제한도 걸 수 있습니다.

* **세분화된 권한** — 사용자가 지정한 작업만 허용합니다
* **강제 지출 한도** — 일일, 월간, 평생 한도를 설정합니다
* **시간 기반 제어** — 정해진 기간이 지나면 자동 만료됩니다
* **즉시 철회** — 통제권은 언제나 사용자에게 있습니다

*예시: 수익 에이전트가 하루 $25,000 한도 안에서 Aave, Morpho, Euler 사이를 리밸런싱할 수 있습니다.*

### [수취인: 에이전트가 필요한 서비스 비용을 결제하도록 합니다](/ko/undefined-1/payees)

시장 데이터 피드, 모델 제공자, 컴퓨트 벤더, 외주 인력, 급여, 구독 서비스처럼 반복적으로 지급할 대상을 미리 승인해 둘 수 있습니다. 결제당 한도, 기간별 한도, 허용 자산, 쿨다운(cooldown)을 설정합니다.

* **사전 승인된 수취인별** 개별 한도
* **자동 결제를 쓰면서도** 자금은 계속 수익을 냄
* **풀 결제(Pull Payment) 지원으로** 구독료와 서비스 요금 처리
* **기간별 한도**로 과지출 방지

*예시: 트레이딩 에이전트는 고정된 USDC 한도 안에서 데이터 피드, 추론 API, GPU 제공자를 계속 가동할 수 있습니다.*

### [디지털 수표: 무조건적인 신뢰 없이 처리하는 일회성 지출](/ko/undefined-1/cheques)

자금 이체를 통제 가능한 결제 약속으로 바꿉니다. 소액은 즉시 처리되고, 큰 금액은 검토 지연 기간 동안 대기하며, 그동안 언제든 취소할 수 있습니다.

* **보안 지연**으로 고액 결제 보호
* **언제든 취소 가능**: 결제 실행 전까지 통제 유지
* **양측 모두에게 투명한 온체인 기록**
* **실제 결제 전까지 자금 락업 없음**

*예시: 에이전트는 $3짜리 데이터셋을 즉시 구매할 수 있고, 더 큰 지급은 검토 창 뒤에서 대기합니다.*

### [화이트리스트: 신뢰하는 주소로 즉시 접근](/ko/undefined-1/whitelist)

가장 신뢰하는 주소에는 무제한 접근을 허용합니다.

* **화이트리스트 주소에는 제한 없음**
* **보안을 위한 타임락 추가**
* **필요하면 즉시 제거 가능**

**이런 분께 적합합니다:** 멀티월렛 전략, 하드웨어 월렛, 콜드 스토리지

> **Underscore는 에이전트에게 실제 자금으로 실행할 수 있게 하면서도 수탁 권한, 프라이빗 키, 무제한 접근은 절대 주지 않습니다. 예산, 수취인 규칙, 자산 제한, 검토 지연, 만료 창은 모두 오픈소스 스마트 컨트랙트에 의해 온체인에서 강제됩니다.**

**→ 자세히 보기:** [**프로그래머블 월렛**](/ko/undefined-1/user-wallet)

***

## 모든 기능이 함께 작동하는 방식

Underscore 인프라는 단일 기능이 아닙니다. 서로 맞물려 작동하는 지능형 기능들의 생태계입니다.

### 에이전트의 하루

**오전 3시**: [수익 에이전트](/ko/undefined-1/managers)가 Morpho가 Aave보다 1% 더 높은 수익을 제공하는 것을 감지합니다. 하루 $25,000 한도 안에서 자동으로 $25k를 리밸런싱합니다. 사용자는 자고 있습니다.

**오전 6시**: 트레이딩 에이전트의 데이터 피드 구독이 갱신됩니다. [수취인](/ko/undefined-1/payees) 한도에서 $200 USDC가 자동으로 빠져나갑니다. 에이전트는 계속 작동합니다.

**오전 10시**: 트레이딩 에이전트가 백테스트용 일회성 데이터셋이 필요합니다. $3짜리 [디지털 수표](/ko/undefined-1/cheques)를 생성하고, 검토 기준 금액 미만이므로 즉시 처리됩니다.

**오후 2시**: 더 큰 규모인 $5,000 컴퓨트 작업 비용을 결제해야 합니다. 에이전트는 3일 검토 창이 있는 수표를 생성합니다. 의심스러운 내역이 있다면 사용자가 취소할 수 있습니다.

**오후 11시**: 오늘 포트폴리오는 5개 프로토콜에 걸쳐 3번 리밸런싱됐습니다. 에이전트는 필요한 서비스 비용도 스스로 결제했습니다. 사용자는 손 하나 까딱하지 않았고, 어떤 키도 공유되지 않았습니다.

### 사용자의 하루

**오전 10시**: 월세 납부일입니다. [수취인](/ko/undefined-1/payees)으로 설정된 집주인이 정확히 $2,500 USDC를 인출합니다. 그 이상은 불가능합니다. 남은 자금은 계속 수익을 냅니다.

**오후 2시**: 외주 인력에게 돈을 보내야 합니다. 3일 지연이 있는 $5,000 [수표](/ko/undefined-1/cheques)를 생성합니다. 일을 완료하지 않으면 취소하면 됩니다.

**오후 4시**: 거래용 지갑에 자금을 넣을 시간입니다. 다른 프로그래머블 월렛으로 $20k를 즉시 옮깁니다. 그 주소는 이미 [화이트리스트](/ko/undefined-1/whitelist)에 올라 있습니다.

***

## 누가 Underscore를 사용하나요

Underscore는 소비자 앱이 아닙니다. 에이전트, 앱, 프로토콜을 위한 인프라입니다. DeFi의 AWS라고 생각하면 됩니다. 다만 완전한 비수탁형입니다.

### Underscore 위에서 만드는 애플리케이션

* **AI 에이전트와 자율 시스템**: 사용자 정의 한도 안에서 [매니저](/ko/undefined-1/managers)로 작동하는 수익 최적화 에이전트, 트레이딩 봇, 자율 경제 주체. [수취인](/ko/undefined-1/payees)과 [수표](/ko/undefined-1/cheques)를 통해 데이터 피드, 컴퓨트, 추론 API 비용도 스스로 결제합니다
* **핀테크 앱**: [Hightop](https://hightop.com)처럼 Underscore를 활용해 사람도 쉽게 쓸 수 있는 AI 에이전트용 디지털 뱅킹을 제공하면서, 사용자가 통제권을 유지한 채 에이전트가 결제하고, 대금을 받고, 유휴 자금을 운용하고, 자금을 이동하게 하는 앱
* **Vault 통합 앱**: 인프라를 직접 만들지 않고도 수익 기능을 추가하고 싶은 앱. [핵심 Vaults](/ko/earn-vaults/vaults)로 패시브 수익을 제공하거나, [Amplified Vaults](/ko/earn-vaults/vaults)로 두 번째 수익 레이어를 제공할 수 있습니다
* **결제 플랫폼**: [수표](/ko/undefined-1/cheques)와 [수취인](/ko/undefined-1/payees)을 활용하는 해외 송금, B2B 결제, 급여 시스템
* **월렛 제공업체**: 기존 월렛에 고급 DeFi 기능과 [프로그래머블 위임](/ko/undefined-1/managers)을 추가하려는 제공업체

### Hightop 사례

Hightop은 Underscore 위에 제품을 구축할 때 무엇이 가능한지 보여줍니다.

* **사람도 쉽게 쓸 수 있는 AI 에이전트용 디지털 뱅킹**: Hightop은 에이전트 자금을 위한 깔끔한 제품 경험을 제공하고, 그 아래의 프로그래머블 제어 레이어는 Underscore가 맡습니다
* **에이전트가 결제하고 대금을 받습니다. 통제권은 당신에게 있습니다.**: Hightop은 에이전트 실행을 [매니저](/ko/undefined-1/managers)에, 반복 결제 상대를 [수취인](/ko/undefined-1/payees)에, 일회성 지급을 [디지털 수표](/ko/undefined-1/cheques)에, 신뢰된 출금 경로를 [화이트리스트](/ko/undefined-1/whitelist)에 매핑합니다
* **월렛, 가스, 자금 이동은 뒤에서 처리됩니다**: Hightop은 [프로그래머블 월렛](/ko/undefined-1/user-wallet) 인프라, 가스, 자금 이동을 추상화하고, Underscore는 한도, 권한, 결제 규칙을 온체인에서 강제합니다
* **Earn Autopilot과 포트폴리오 실행은 Underscore 위에서 돌아갑니다**: [핵심 Vaults](/ko/earn-vaults/vaults), [Amplified Vaults](/ko/earn-vaults/vaults), Underscore 레고가 수익, 스왑, 정책 인지형 자산 실행을 25개 이상의 지원 자산 전반에서 처리하고, Ripe는 대출 레이어와 Amplified Vault 뒤의 레버리지 레일을 담당합니다
* **x402 지원 플로우는 이미 제공되고, 카드는 곧 출시됩니다**: Hightop은 이미 에이전트를 위한 API 네이티브 인바운드 결제를 지원하며, 같은 제어 모델을 가상 카드까지 확장하고 있습니다

대부분의 사용자는 Underscore와 직접 상호작용하지 않아도 됩니다. 대신 Hightop 같은 앱을 통해 자연스럽게 Underscore 인프라를 쓰게 됩니다.

**→ 자세히 보기:** [**Underscore를 사용하는 곳**](/ko/undefined/who-uses-underscore)

***

## 자주 묻는 질문

**내 월렛은 업그레이드 가능한가요?**\
아니요. 보안을 위해 월렛 코드는 불변입니다. 새 기능은 DeFi 레고를 통해 제공됩니다. 새로운 기능이 필요하다면 새 프로그래머블 월렛으로 마이그레이션할 수 있습니다.

**DeFi 레고란 무엇인가요?**

DeFi 프로토콜과 연결되는 표준화된 통합 계층입니다. 새로운 프로토콜이 출시되면 월렛은 이를 즉시 활용할 수 있습니다.

**여러 개의 월렛을 사용할 수 있나요?**\
네. 서로를 화이트리스트에 추가하면 월렛 간 즉시 전송이 가능합니다.

**L2는 어떤 체인을 지원하나요?**\
현재는 Base L2만 지원합니다. 더 많은 체인이 추가될 예정입니다.

**수수료는 어떻게 작동하나요?**\
스왑에는 소액 수수료(0.25%), 외부 보상 청구에는 20% 수수료가 부과됩니다. Earn Vaults는 발생한 수익금에 대해서만 20% 성과 수수료를 부과합니다. 전송, 예치, 유휴 자금에는 수수료가 없습니다. 프로토콜 수익의 100%는 공개 시장에서 [$RIPE](https://app.ripe.finance/ripe)를 바이백하는 데 사용됩니다. 자세한 내용은 [프로토콜 이코노믹스](/ko/undefined-2/protocol-economics)를 참고하세요.

**소유자 지갑을 잃어버리면 어떻게 되나요?**\
미리 매니저와 화이트리스트 주소를 설정해 두었다면, 매니저가 하드웨어 월렛 같은 화이트리스트 주소로 자금을 옮겨 복구 경로를 마련할 수 있습니다.

**매니저가 내 자금을 훔칠 수 있나요?**\
아니요. 매니저는 블록체인에서 강제되는 한도 안에서만 작동합니다. 승인된 작업만, 설정된 지출 한도 안에서만 수행할 수 있으며, 외부 주소로 출금하거나 자신의 권한을 수정할 수 없습니다.

**긴급 전송은 어떻게 처리하나요?**\
하드웨어 월렛이나 안전한 주소를 미리 화이트리스트에 올려 두세요. 수취인은 한도가 있고, 수표는 지연이 있지만, 화이트리스트 주소는 긴급 상황에서도 즉시 무제한 전송을 받을 수 있습니다.

***

## 결제 수단 비교

상황에 따라 어떤 결제 도구를 써야 하는지 한눈에 정리하면 다음과 같습니다.

| 기능            | [**화이트리스트**](/ko/undefined-1/whitelist) | [**수취인**](/ko/undefined-1/payees) | [**수표**](/ko/undefined-1/cheques) |
| ------------- | --------------------------------------- | --------------------------------- | --------------------------------- |
| **사용 사례**     | 신뢰하는 주소로 즉시 무제한 전송                      | 자동 반복 결제                          | 통제가 가능한 일회성 결제                    |
| **결제 한도**     | 없음, 완전 무제한                              | 수취인별 맞춤 설정 가능                     | 수표별로 설정                           |
| **설정 시간**     | 타임락 추가 필요(설정 가능)                        | 한도와 함께 즉시 설정                      | 별도 설정 불필요                         |
| **핵심 장점**     | 긴급 접근 및 멀티월렛 전략                         | 한 번 설정하면 자동 실행                    | 현금화 전까지 언제든 취소 가능                 |
| **가장 적합한 대상** | 하드웨어 월렛, 콜드 스토리지, 다른 월렛                 | 에이전트 서비스, 급여, 구독                  | 에이전트 구매, 외주 인력, 대규모 전송            |
| **위험 수준**     | 가장 높음, 월렛을 비울 수 있음                      | 중간, 한도로 제한됨                       | 낮음, 취소 가능                         |

***

## 시작하기

### 빠른 시작

**패시브 수익을 원하시나요? (2분)**

1. Underscore에 월렛을 연결합니다
2. 수익 프로필을 선택합니다. 패시브 수익은 핵심 Vaults, 증폭 수익은 Amplified Vaults입니다
3. 예치하면, 그다음부터는 AI가 모두 처리합니다

**AI 에이전트를 만들고 있나요? (10분)**

1. [프로그래머블 월렛](/ko/undefined-1/user-wallet)을 배포합니다
2. 권한과 예산을 설정해 에이전트를 [매니저](/ko/undefined-1/managers)로 추가합니다
3. 반복 서비스 비용용 [수취인](/ko/undefined-1/payees)을 설정합니다 (데이터 피드, 컴퓨트, API 등)
4. 일회성 결제에는 [디지털 수표](/ko/undefined-1/cheques)를 사용합니다

**완전한 통제를 원하시나요? (5분)**

1. [프로그래머블 월렛](/ko/undefined-1/user-wallet)을 배포합니다
2. 필요에 따라 매니저, 수취인, 화이트리스트 주소를 추가합니다
3. 한곳에서 20개 이상의 DeFi 프로토콜을 사용하기 시작합니다

### 기능 살펴보기

**패시브 수익용**: [핵심 Vaults](/ko/earn-vaults/vaults)부터 시작하세요. 예치하면 AI가 최적화를 수행합니다. 별도의 월렛 설정은 필요 없습니다.

**증폭 수익용**: [Amplified Vaults](/ko/earn-vaults/vaults)를 살펴보세요. BTC 또는 USDC 노출을 유지하면서 Ripe를 통해 두 번째 수익 레이어를 더할 수 있습니다.

**AI 에이전트용**: [프로그래머블 월렛](/ko/undefined-1/user-wallet)을 배포하고, 실행 권한용 [매니저](/ko/undefined-1/managers), 반복 비용용 [수취인](/ko/undefined-1/payees), 일회성 지출용 [수표](/ko/undefined-1/cheques)를 구성하세요.

**완전한 통제용**: [프로그래머블 월렛](/ko/undefined-1/user-wallet)을 배포한 뒤 필요에 맞는 기능을 선택하세요.

* **자동화를 원한다면**: [매니저](/ko/undefined-1/managers)로 운영 권한을 위임하세요
* **반복 결제가 필요하다면**: [수취인](/ko/undefined-1/payees)을 설정하세요
* **일회성 결제가 필요하다면**: 취소 가능한 [수표](/ko/undefined-1/cheques)를 사용하세요
* **멀티월렛 전략을 원한다면**: [화이트리스트](/ko/undefined-1/whitelist)에 주소를 추가하세요
* **보상을 받고 싶다면**: [수익 공유와 보너스](/ko/undefined-2/rewards)를 살펴보세요

***

## 기술 문서

개발자와 통합사를 위한 자료: [전체 기술 문서](https://underscore-1.gitbook.io/developers/)

Underscore 인프라 위에 구축할 수 있도록 스마트 컨트랙트 아키텍처, DeFi 레고 파트너 통합, 보안 모델에 대한 자세한 가이드를 제공합니다. 실제 운영 중인 30개 이상의 컨트랙트와 통합 예시가 문서화되어 있습니다.

실시간 프로토콜 파라미터와 컨트랙트 배포 정보는 [Params Explorer](https://params.underscore.finance)에서 확인할 수 있습니다.

***

## 커뮤니티 및 지원

* **Discord**: [discord.gg/hightop](https://discord.gg/hightop)
* **Twitter/X**: [@underscore\_hq](https://x.com/underscore_hq)
* **GitHub**: [github.com/underscore-finance](https://github.com/underscore-finance/underscore-protocol)

***

## 금융 운영의 미래

AI 에이전트에게는 API만으로는 부족합니다. 서비스 비용을 지불하고, 수익을 확보하고, 안전한 경계 안에서 자금을 자율적으로 이동시킬 수 있는 돈이 필요합니다.

Underscore는 암호화폐가 약속했던 것을 현실로 만듭니다. 사용자가 설정한 깨지지 않는 경계 안에서 전략을 실행하는 프로그래머블 머니입니다. 자금은 프로토콜 전반에서 수익을 창출하면서도, 결제를 위한 유동성은 유지합니다. 보안은 강하게 지키되, 사용성을 막지 않습니다.

Earn Vaults + 프로그래머블 월렛. 당신의 돈은 잠들지 않습니다.


# Underscore를 사용하는 곳

프로그래머블 결제와 Earn Vaults를 기반으로 구축하는 에이전트, 앱, 프로토콜을 위한 인프라

Underscore는 에이전트, 앱, 프로토콜을 위한 인프라입니다. 일부 사용자는 Hightop처럼 Underscore를 활용해 사람도 쉽게 쓸 수 있는 AI 에이전트용 디지털 뱅킹을 제공하는 앱을 통해 이를 경험합니다. 다른 사용자는 프로그래머블 월렛 안에서 작동하는 AI 시스템을 통해 접합니다. 대부분의 최종 사용자는 그 존재를 직접 인식하지 못합니다.

Underscore는 DeFi의 AWS와 비슷하다고 생각하면 됩니다. 다만 완전한 비수탁형입니다. 수백만 명이 Amazon 서버를 의식하지 않은 채 Netflix를 쓰듯, 앞으로 수백만 명이 Underscore 인프라 위에서 돌아가는 금융 앱을 쓰게 될 것입니다. 차이는 하나입니다. 사용자는 언제나 자금에 대한 통제권을 유지합니다. 복잡성은 인프라 계층 아래에 숨어 있고, 사용자는 매끄러운 경험만 얻게 됩니다.

Underscore는 두 가지 핵심 제품을 제공합니다. 누구나 접근할 수 있는 [**Earn Vaults**](/ko/earn-vaults/vaults), 여기에는 핵심 Vaults와 Amplified Vaults가 포함됩니다. 그리고 [매니저](/ko/undefined-1/managers), [수취인](/ko/undefined-1/payees), [수표](/ko/undefined-1/cheques), [화이트리스트](/ko/undefined-1/whitelist)를 갖춘 \*\*[프로그래머블 월렛](/ko/undefined-1/user-wallet)\*\*입니다. 이는 AI 에이전트와 운영자가 온체인 규칙 안에서 실제 자금으로 실행할 수 있도록 설계된 프로그래머블 월렛입니다.

## 인센티브가 정렬된 경제 모델

* 프로토콜은 사용자가 벌 때만 법니다. Underscore 수익의 대부분은 Vault 이익에 대해서만 부과되는 20% 성과 수수료에서 나옵니다
* 추가적인 소액 수익원은 스왑 수수료와 외부 보상 청구 수수료입니다
* 예치, 전송, 유휴 자금, 원금에는 수수료가 없습니다
* 프로토콜 수익의 100%는 공개 시장에서 [$RIPE](https://app.ripe.finance/ripe)를 바이백하는 데 사용됩니다
* 수수료 구조, 예시, 온체인 검증은 [프로토콜 이코노믹스](/ko/undefined-2/protocol-economics)에서 확인할 수 있습니다

## Underscore 생태계

### 누가 Underscore 위에 구축하나요

**핀테크 애플리케이션**

* DeFi 수익이 필요한 소비자 대상 앱
* 암호화폐 서비스를 제공하는 네오뱅크
* 자동화된 자금 흐름이 필요한 결제 처리업체
* [Earn Vaults](/ko/earn-vaults/vaults)를 통합해 핵심 Vaults의 패시브 수익이나 Amplified Vaults의 두 번째 수익 레이어를 제공하는 앱

**암호화폐 월렛**

* 고급 DeFi 기능을 추가하려는 월렛
* [프로그래머블 위임](/ko/undefined-1/managers)이 필요한 월렛 제공업체
* 자동화가 필요한 멀티시그 솔루션

**AI 에이전트 및 자율 시스템**

* **수익 최적화 에이전트**: 프로그래머블 월렛 안에서 [매니저](/ko/undefined-1/managers)로 작동하며, 엄격한 예산과 프로토콜 제한 안에서 Aave, Morpho, Euler, Compound 사이를 24시간 리밸런싱합니다
* **트레이딩 에이전트**: 고정 예산을 가진 [수취인](/ko/undefined-1/payees)을 통해 시장 데이터 피드, 추론 API, 컴퓨트 리소스 비용을 지불하며, 자신의 인프라를 자율적으로 유지합니다
* **자율 경제 주체**: [디지털 수표](/ko/undefined-1/cheques)를 사용해 데이터셋, 임시 컴퓨트, 분석 리포트 같은 일회성 구매를 처리하며, 큰 구매에는 검토 지연을 적용합니다
* **에이전트 오케스트레이터**: 하나의 프로그래머블 월렛 안에서 여러 에이전트를 배포하고, 각 에이전트에 별도의 매니저 권한, 예산, 자산 제한을 부여하는 플랫폼

Underscore는 에이전트에게 실제 자금으로 실행할 수 있게 하면서도 수탁 권한, 프라이빗 키, 무제한 접근은 절대 주지 않습니다. 예산, 수취인 규칙, 자산 제한, 검토 지연, 만료 창은 모두 온체인에서 강제됩니다.

**엔터프라이즈 솔루션**

* B2B 결제 플랫폼
* 기업 재무 관리
* DAO 재무 운영
* 기관급 DeFi 접근

### 최종 사용자는 Underscore를 어떻게 경험하나요

사용자는 친숙한 앱을 사용하고, 복잡한 처리는 Underscore가 맡습니다.

* **수익 창출**: "USDC를 예치하고 연 8% 수익을 받으세요" → [핵심 Vaults](/ko/earn-vaults/vaults)가 자동으로 최적의 프로토콜로 라우팅
* **결제**: "외주 인력에게 $500 보내기" → Underscore [수표 시스템](/ko/undefined-1/cheques)이 안전하게 처리
* **포트폴리오 관리**: "AI가 내 수익을 최적화한다" → Underscore [매니저](/ko/undefined-1/managers)가 전략 실행
* **자산 스왑**: "ETH를 USDC로 거래" → Underscore가 DEX 전반에서 최적 경로 탐색
* **대출**: "ETH를 담보로 빌리기" → Underscore의 Ripe Protocol 레고가 담보를 안전하게 관리
* **수익 창출형 담보**: "수익 지분 토큰을 담보로 사용하기" → [핵심 Vault 지분 토큰](/ko/earn-vaults/vaults)이 수익을 내면서 Ripe에서 담보로 작동

사용자가 보는 것은 단순한 인터페이스뿐입니다. 복잡한 작업은 Underscore가 처리합니다.

## 사례 연구: Hightop

[Hightop](https://hightop.com)은 사람도 쉽게 쓸 수 있는 AI 에이전트용 디지털 뱅킹입니다. 에이전트가 결제하고 대금을 받습니다. 통제권은 당신에게 있습니다.

Hightop은 [프로그래머블 월렛](/ko/undefined-1/user-wallet) 인프라, 가스, 자금 이동을 뒤에서 처리합니다.

그 아래에서 Underscore는 에이전트 권한, 결제, 출금, Earn Autopilot, 포트폴리오 실행을 위한 자금 제어 및 실행 레이어를 제공합니다. Hightop의 Earn Autopilot은 핵심 Vaults와 Amplified Vaults를 모두 사용하며, 대출과 Amplified Vault 뒤의 레버리지 레일은 Ripe가 담당합니다.

### Hightop이 사용자에게 제공하는 것

하나의 앱 안에서 Hightop 사용자는 다음을 할 수 있습니다.

* **계정에 자금을 넣고** 익숙한 입출금 경로로 자금을 이동
* **각 에이전트별로 한도, 권한, 결제 규칙을 설정**
* **에이전트가 결제하고, 대금을 받고, 수익을 운용하고, 대출하고, 투자하고, 자금을 이동하게 함**. 프라이빗 키나 무제한 월렛 접근 권한은 주지 않음
* **단순한 앱에서 모든 것을 관리**하면서 [프로그래머블 월렛](/ko/undefined-1/user-wallet) 인프라, 가스, 자금 이동은 뒤로 감추고 제어 레이어는 온체인에서 검증 가능하게 유지

### 각 기능을 Underscore가 어떻게 뒷받침하나요

**에이전트 제어 레이어**

* Hightop의 에이전트 제어 프로필은 Underscore [매니저](/ko/undefined-1/managers)에 매핑됩니다
* 월렛 전체 규칙과 에이전트별 규칙이 각 에이전트가 무엇을 할 수 있는지, 어떤 자산과 거래 경로를 건드릴 수 있는지, 누구에게 지급할 수 있는지, 얼마까지 지출할 수 있는지, 언제 만료되는지를 정합니다
* 핵심 경계는 앱 백엔드가 기억하는 규칙이 아니라 불변의 오픈소스 스마트 컨트랙트에 의해 온체인에서 강제됩니다
* 이 신뢰 모델은 앱 뒤에 숨은 불투명한 중앙화 수탁이 아니라, 투명한 온체인 스마트 컨트랙트 인프라 위에 서 있습니다

**결제와 자금 이동**

* 승인된 반복 결제 상대는 Underscore [수취인](/ko/undefined-1/payees)에 매핑됩니다
* 임시 지급과 더 큰 구매는 선택적 검토 지연과 취소 기간이 있는 [디지털 수표](/ko/undefined-1/cheques)를 사용합니다
* 신뢰된 출금 및 셀프커스터디 경로는 [화이트리스트](/ko/undefined-1/whitelist)를 통해 승인된 목적지로 즉시 이동할 수 있습니다
* 에이전트는 일회성, 사용량 기반, x402 호환 HTTP 흐름으로도 대금을 받을 수 있습니다. 리서치 에이전트는 요청당 대금을 받고, 서포트 에이전트는 워크플로우당 대금을 받을 수 있습니다
* 이렇게 해서 Hightop은 에이전트에게 무제한 계정 접근을 주지 않고도 벤더 결제, 수금, 자금 이동을 허용합니다

**Earn Autopilot**

* Hightop의 Earn Autopilot은 Underscore의 수익 레고와 [핵심 Vaults](/ko/earn-vaults/vaults), [Amplified Vaults](/ko/earn-vaults/vaults)를 함께 사용해 여러 수익 프로필에 걸쳐 유휴 자금을 생산적으로 운용합니다
* Hightop의 AI 오토파일럿은 사용자를 프로토콜 복잡성에 노출시키지 않으면서 수익을 극대화하고 포트폴리오 관리를 도울 수 있습니다

**포트폴리오 실행**

* 스왑과 포트폴리오 이동은 Underscore의 DEX 통합을 통해 실행됩니다
* 에이전트는 Aerodrome, Uniswap, Curve 같은 거래 경로에서 지원 자산을 사고, 포트폴리오 목표 비중으로 리밸런싱하고, 승인된 전략을 실행할 수 있습니다
* 실행은 정책 인지형으로 유지되므로, 에이전트는 정해진 범위를 벗어나지 않고 목표 비중으로 리밸런싱하고 익스포저를 회전시킬 수 있습니다

**카드 (출시 예정)**

* Hightop은 같은 제어 모델 위에 가상 카드를 얹는 방향도 강조하고 있습니다
* 각 에이전트는 자신만의 가상 카드를 가질 수 있고, 지출 규칙은 온체인에서 강제되며, 카드 잔액은 결제 시점에 Earn에서 자동으로 충전될 수 있습니다

**대출**

* Hightop은 대출을 단순한 앱 내 기능으로 보여 줍니다
* 대출 레이어는 Ripe가 담당하고, Amplified Vault 뒤의 레버리지 레일도 Ripe가 제공합니다. Underscore는 그 주변의 에이전트 제어, [프로그래머블 월렛](/ko/undefined-1/user-wallet) 권한 모델, 에이전트 실행 모델을 처리합니다

### Hightop 사용자 경험

사용자 관점에서는 다음과 같습니다.

1. [Hightop](https://hightop.com) 앱 다운로드
2. 익숙한 은행 또는 암호화폐 경로로 계정에 자금 넣기
3. 에이전트를 만들고 명확한 규칙 부여
4. 해당 에이전트가 정해진 범위 안에서 결제, 수금, 수익 운용, 투자, 포트폴리오 보호를 수행하게 함
5. 필요할 때 대출하고, 언제든 신뢰된 목적지로 출금

사용자가 보지 못하는 것:

* 20개 이상의 프로토콜에 대한 토큰 승인
* 수익 프로토콜 비교와 현금 라우팅 로직
* 슬리피지 계산
* 스마트 컨트랙트 상호작용
* 에이전트 권한, 결제 경로 규칙, 지출 가드레일
* 가스, 프라이빗 키, 시드 구문이라는 개념 자체

사용자는 그저 깔끔한 제품을 쓸 뿐이고, 자금 레이어는 프로그래밍 가능한 상태로 남습니다. 이것이 Underscore 위에 구축한다는 것의 힘입니다.

## 사례 연구: AI 트레이딩 에이전트

트레이딩 에이전트는 자율적으로 움직여야 합니다. 포지션을 리밸런싱하고, 데이터 피드 비용을 지불하고, 가끔 데이터셋도 구매해야 합니다. 그 모든 것을 수탁 권한이나 프라이빗 키 없이 해야 합니다.

### Underscore가 에이전트 운영을 뒷받침하는 방식

**실행 권한 (**[**매니저**](/ko/undefined-1/managers)**)**

* 에이전트는 월렛 소유자의 프로그래머블 월렛에서 매니저로 설정됩니다
* 권한: 매수·매도, 수익 관리, 승인된 수취인으로의 일반 전송
* 한도: 일일 $25,000, 스테이블코인만, 승인된 프로토콜만
* 시간 제어: 6시간 쿨다운, 갱신 가능한 90일 만료

**반복 비용 (**[**수취인**](/ko/undefined-1/payees)**)**

* 데이터 피드 제공자: 월 $200 풀 결제
* 추론 API: 월 $1,000, 최대 50회
* 컴퓨트 벤더: 주 $500

**일회성 구매 (**[**수표**](/ko/undefined-1/cheques)**)**

* $100 이하 데이터셋 구매: 즉시 처리
* 더 큰 구매: 3일 검토 창, 소유자가 취소 가능

**에이전트가 절대 받지 못하는 것:**

* 프라이빗 키
* 새로운 결제 수취인 추가 권한
* 예산을 초과하는 접근
* 제한된 자산을 건드릴 권한

에이전트는 실제 자금으로 실행합니다. 소유자는 완전한 통제권을 유지합니다. 모든 경계는 온체인에서 강제됩니다.

## Vault 통합에 최적인 이유

어떤 애플리케이션에도 AI 관리형 수익을 가장 빠르게 추가하는 방법입니다.

### 왜 Vault를 통합해야 하나요

Underscore Earn Vaults는 하나의 아키텍처를 공유하지만 두 가지 수익 프로필을 제공합니다. 핵심 Vaults는 패시브 AI 관리형 수익을, Amplified Vaults는 Ripe 기반의 두 번째 수익 레이어를 제공합니다.

**핀테크 앱용**

몇 달에 걸친 인프라 개발을 건너뛰고 [핵심 Vaults](/ko/earn-vaults/vaults)를 직접 통합하거나, [Amplified Vaults](/ko/earn-vaults/vaults)를 중심으로 두 번째 수익 레이어를 제공할 수 있습니다.

* 표준 ERC-4626 인터페이스라 통합 부담이 작음
* AI 최적화는 전부 Underscore가 처리
* 사용자는 앱 인터페이스에서 예치하고, 앱은 지분 토큰만 추적하면 됩니다
* 월렛 인프라를 직접 만들 필요 없음

**DeFi 프로토콜용**

담보를 생산적으로 만들 수 있습니다.

* 핵심 Vault 지분 토큰을 담보로 수용
* 사용자는 대출을 받는 동안에도 수익 창출
* 표준 ERC-20 호환
* Vault 가치도 온체인에서 추적 가능

**포트폴리오 매니저용**

직접 인프라를 만들지 않고도 관리형 전략을 제공할 수 있습니다.

* 단순 수익 최적화를 위한 핵심 Vaults
* 리스크 관리가 내장된 더 높은 수익을 원하는 Amplified Vaults
* 자체 브랜드 상품처럼 화이트라벨 가능
* 인프라보다 사용자 확보에 집중 가능

### 예시: 빠른 Vault 통합

결제 앱이 사용자 유휴 자금에 수익을 붙이고 싶다고 가정해 봅시다.

```
기존 접근:
- 수익 인프라 구축 (3~6개월)
- 여러 프로토콜 통합 (지속적 유지보수)
- 리밸런싱 로직 구축 (보안 리스크)
- 전체 감사 진행 ($$$$)

Vault 접근:
- 사용자 자금으로 deposit() 호출
- 내부적으로 사용자 지분 토큰 추적
- 출금 시 redeem() 호출
- 2주 내 완료
```

Vault는 프로토콜 선택, 리밸런싱, 보상 청구, 리스크 관리를 담당합니다. 앱은 사용자 경험에만 집중하면 됩니다.

***

## 결제 애플리케이션에도 최적

Underscore의 결제 인프라는 차세대 결제 앱에 특히 적합합니다.

### 해외 송금 앱

다음과 같은 방식으로 국제 송금을 바꿀 수 있습니다.

* \*\*[수표](/ko/undefined-1/cheques)\*\*를 통한 안전하고 취소 가능한 전송, 기본 사기 방지 포함
* \*\*[수취인](/ko/undefined-1/payees)\*\*을 통한 한도 있는 가족 송금 자동화
* **즉시 정산**: 수취 전까지 자금은 수익을 내고, 송금은 스테이블코인으로 처리
* **풀 결제(Pull Payment)**: 수취인이 환율이 유리할 때 직접 인출 가능

### B2B 글로벌 결제 플랫폼

다음과 같은 방식으로 기업 결제를 혁신할 수 있습니다.

* **자동 송장 처리**: [수취인](/ko/undefined-1/payees)과 net-30/60/90 결제 조건
* **에스크로 유사 기능**: 승인 워크플로가 있는 [수표](/ko/undefined-1/cheques)
* **다중 통화 금고**: 결제 주기 사이에도 수익 창출
* **위임된 결제 승인**: 재무팀용 [매니저](/ko/undefined-1/managers)

### 급여 및 비용 플랫폼

다음과 같은 방식으로 직원 지급을 현대화할 수 있습니다.

* **풀 기반 급여**: 직원이 자신의 급여를 정확한 금액만큼 인출
* **비용 상환**: 자동 한도와 승인 흐름 적용
* **외주 결제**: 취소 가능한 [수표](/ko/undefined-1/cheques) 사용
* **다단계 승인 체계**: [매니저](/ko/undefined-1/managers) 권한으로 구현

### 왜 결제에 Underscore인가

* **프로그래머블 머니**: 모든 결제 관계에 정확한 규칙 설정
* **대기 자금 수익화**: 필요 직전까지 자금이 DeFi 수익 창출
* **사기 방지**: 타임락, 취소, 한도가 사용자 보호
* **글로벌 즉시 정산**: 은행 영업시간도, 중개 은행도 필요 없음
* **규제 친화성**: 명확한 감사 추적과 권한 시스템

## 개발자가 Underscore를 선택하는 이유

**출시 속도**

* 몇 달이 아니라 몇 주 만에 DeFi 기능 출시
* 한 번의 통합으로 주요 DeFi 프로토콜 전체에 접근
* 미리 구축된 위임 및 결제 시스템
* 첫날부터 실서비스에 바로 쓸 수 있는 스마트 컨트랙트

**리스크 절감**

* 메인넷에서 검증된 보안 패턴
* 타임락과 권한으로 보호되는 사용자 자금
* 모든 트랜잭션에 대한 명확한 감사 추적
* 무제한 토큰 승인이나 허니팟(honeypot) 리스크 없음

**미래 대응성**

* 새 프로토콜이 DeFi 레고를 통해 자동으로 사용 가능
* 프로토콜이 업데이트돼도 재통합 불필요
* 멀티체인 확장을 염두에 둔 구조
* 커뮤니티 주도의 프로토콜 추가

## 미래: 보이지 않는 인프라

Underscore가 성장할수록 오히려 더 보이지 않게 됩니다. 사람들은 "이거 Underscore를 쓰나요?"라고 묻지 않게 될 것입니다. 마치 "이거 HTTPS를 쓰나요?"라고 묻지 않는 것처럼요. Underscore는 결국 다음 분야의 표준 인프라가 될 것입니다.

* **DeFi 수익을 제공하는 모든 핀테크**
* **고급 기능을 갖춘 모든 월렛**
* **포트폴리오를 관리하고 스스로 서비스 비용을 지불하는 모든 AI 에이전트**
* **결제 자동화가 필요한 모든 플랫폼**

가장 좋은 인프라는 배경으로 사라지고, 마법처럼 느껴지는 경험만 남깁니다.

***

## 함께 구축해 봅시다

Underscore 위에 구축할 준비가 되었거나, 금융 인프라의 미래를 더 알고 싶으신가요?

### 연결하기

* **Discord 커뮤니티**: 개발자 토론에 참여하세요 [discord.gg/hightop](https://discord.gg/hightop)
* **업데이트 팔로우**: Twitter/X [@underscore\_hq](https://x.com/underscore_hq)
* **GitHub**: 코드 살펴보기 [github.com/underscore-finance](https://github.com/underscore-finance/underscore-protocol)

다음 10억 달러짜리 핀테크를 만들고 있든, 결제 흐름을 최적화하든, AI 기반 금융 도구를 만들고 있든, 커뮤니티가 함께 도울 준비가 되어 있습니다.

***

기억하세요. 최고의 인프라는 배경으로 사라집니다. Underscore는 복잡한 부분을 맡고, 개발자는 에이전트, 앱, 운영자가 실제 돈을 안전하게 움직일 수 있는 제품을 만드는 데 집중할 수 있습니다.


# DeFi 통합

Underscore 월렛을 통해 접근할 수 있는 전체 DeFi 프로토콜 목록

Underscore 월렛은 "DeFi 레고"라고 부르는 표준화된 어댑터를 통해 20개 이상의 DeFi 프로토콜에 연결됩니다. 현재 사용할 수 있는 전체 목록은 아래와 같습니다.

## 수익 및 대출 프로토콜

| 프로토콜              | 유형     | 할 수 있는 일                       |
| ----------------- | ------ | ------------------------------ |
| **Aave V3**       | 대출     | 예치하여 수익 창출                     |
| **Morpho**        | 대출     | 경쟁력 있는 금리의 격리형 대출 마켓           |
| **Compound V3**   | 대출     | 예치하여 수익 창출                     |
| **Euler**         | 대출     | 예치하여 수익 창출, 격리형 대출 마켓          |
| **Fluid**         | 대출     | 예치하여 수익 창출                     |
| **Moonwell**      | 대출     | Base 네이티브 대출 프로토콜              |
| **Ripe Protocol** | 스테이블코인 | 어떤 담보로든 GREEN/sGREEN 대출        |
| **Sky PSM**       | 스테이블코인 | MakerDAO의 Peg Stability Module |
| **40 Acres**      | 수익     | 특화된 수익 전략                      |
| **Wasabi**        | 수익     | 수익 최적화                         |
| **Avantis**       | 수익     | 수익 집계                          |
| **ExtraFi**       | 수익     | 추가 수익원                         |

## 탈중앙화 거래소

| 프로토콜           | 유형         | 할 수 있는 일                                |
| -------------- | ---------- | --------------------------------------- |
| **Aerodrome**  | DEX        | 스왑, LP 제공 (Classic + Slipstream 집중 유동성) |
| **Uniswap V2** | DEX        | 스왑, 단순 유동성 공급                           |
| **Uniswap V3** | DEX        | 스왑, 집중 유동성 (NFT 포지션)                    |
| **Curve**      | Stableswap | 낮은 슬리피지의 스테이블코인 스왑, LP 제공               |

## 자동 프로토콜 접근

월렛은 미래에도 유효하도록 설계되어 있습니다. 새 프로토콜이 통합되면:

* 마이그레이션이 필요 없습니다
* 월렛 업데이트가 필요 없습니다
* 새로운 레고가 배포되는 즉시 자동으로 사용할 수 있습니다
* 기존의 모든 보안 설정이 그대로 적용됩니다

**실시간 데이터**: [Params Explorer](https://params.underscore.finance/legos)에서 현재 활성화된 통합과 온체인 상태를 확인하세요.

## 프로토콜 안전성

통합된 모든 프로토콜은 다음 기준을 충족합니다.

* 충분한 TVL을 보유한 검증된 프로토콜
* 신뢰받는 보안 감사 업체의 감사를 완료
* 메인넷에서 충분히 검증된 운영 이력 보유

Underscore는 엄격한 보안 기준을 충족하는 프로토콜만 통합합니다.

## DeFi 레고란 무엇인가요?

레고는 각 프로토콜에 대한 접근을 제공하는 표준화된 어댑터입니다. 서로 다른 스마트 컨트랙트와 상호작용하는 복잡성을 뒤에서 처리하면서, 일관된 인터페이스를 유지해 줍니다.

**레고 아키텍처의 장점**:

* **단순성**: 모든 프로토콜에 하나의 인터페이스로 접근
* **안전성**: 보호 장치가 내장된 감사 완료 어댑터
* **미래 대응성**: 새 프로토콜도 자동으로 사용 가능
* **조합 가능성**: 여러 프로토콜 작업을 하나의 트랜잭션으로 결합


# Earn Vaults: 핵심 Vaults와 Amplified Vaults

Earn Vaults는 핵심 Vaults의 패시브 AI 관리형 수익과 Amplified Vaults의 Ripe 기반 수익 증폭을 함께 제공합니다

Underscore Earn Vaults는 하나의 아키텍처 위에서 두 가지 수익 프로필을 제공합니다.

* **핵심 Vaults**: 표준 ERC-4626 지분 토큰으로 감싼 AI 관리형 패시브 수익
* **Amplified Vaults**: 핵심 Vault 지분 토큰 위에 구축되며, Ripe Protocol을 사용해 두 번째 수익 레이어를 추가하면서도 차입된 자금은 USD 기준 전략 안에 유지됩니다

Earn Vaults는 비수탁형입니다. 자산은 계속 사용자 소유입니다. 별도 허가 없이 언제든 인출할 수 있습니다.

[프로그래머블 월렛](/ko/undefined-1/user-wallet)과의 핵심 차이는 포지션이 묶이지 않는다는 점입니다. Vault 지분 토큰은 DeFi 어디서든 사용할 수 있는 조합 가능한 토큰입니다. 거래하고, 담보로 쓰고, 체인 간 브리지할 수 있습니다. 토큰이 어디로 가든, 그 아래에서 돌아가는 전략은 계속 작동합니다.

***

## 왜 Earn Vaults가 필요한가

### 탄생 배경

Vaults는 탁상공론으로 만든 것이 아닙니다. 실제로 우리가 겪은 문제에서 출발했습니다.

우리는 [Hightop](https://hightop.com)에서 시작했습니다. Hightop은 Underscore를 활용해 사람도 쉽게 쓸 수 있는 AI 에이전트용 디지털 뱅킹을 제공합니다. 그곳에서 가장 먼저 다룬 흐름 중 하나가 Earn Autopilot이었습니다. 유휴 자금을 계속 생산적으로 운용하고, 시장을 모니터링하고, 개별 [프로그래머블 월렛](/ko/undefined-1/user-wallet)을 더 나은 수익 기회 쪽으로 리밸런싱하는 흐름이었습니다. 동작은 했지만 금방 한계에 부딪혔습니다. 최적화 한 번마다 모든 월렛을 각각 건드려야 했기 때문입니다. 10,000명의 사용자에게 같은 개선 전략을 적용하려면 10,000개의 별도 트랜잭션이 필요했습니다. 비용도 크고, 속도도 느렸고, 에이전트는 같은 결과를 원하는 사용자에게 똑같은 작업을 반복하고 있었습니다.

그다음에는 Ripe Protocol이 있었습니다. 사용자들은 수익을 내는 포지션, 예를 들어 Aave 예치나 Morpho 포지션을 담보로 대출을 받기 시작했습니다. 하지만 그 포지션이 담보가 되는 순간 자금은 사실상 묶였습니다. 더 나은 수익 기회가 나타나더라도, 사용자는 대출을 먼저 상환하기 전까지는 그 담보를 리밸런싱할 수 없었습니다. 수익을 내는 자산이 그대로 갇혀 버린 것입니다.

두 문제의 뿌리는 같았습니다. 실제 사용자, 실제 사용량, 실제 피드백에서 나온 문제였습니다. 개별 월렛 전반에 걸쳐 Hightop의 수익 자동화를 대규모로 운영하며 비효율을 직접 겪었습니다.

그래서 Earn Vaults를 만들었습니다. 핵심 통찰은 이랬습니다. 프로그래머블 월렛으로 만든 모든 것, AI 기능, 명확한 경계, 온체인 규칙과 정책은 그대로 유지하되, AI가 관리해야 할 "월렛"을 하나로 줄이자. 사용자는 공유 Vault에 예치하고 자신의 지분을 나타내는 토큰을 받습니다. AI는 한 번 최적화하고, 모두가 그 혜택을 받습니다. 그리고 핵심 Vault 지분 토큰은 표준 토큰이기 때문에, 사용자는 그 토큰을 Ripe에서 담보로 쓰는 동안에도 AI가 기초 포지션을 계속 최적화할 수 있습니다.

이 아키텍처는 새로운 Vault 유형의 길도 열었습니다. Amplified Vaults, 인덱스 Vault 등 모두 같은 기반 위에 세울 수 있게 됐습니다.

오늘날 Earn Vaults는 이미 운영 중이며, 핵심 Vaults와 Amplified Vaults 모두 Hightop에서 운영 중인 Earn Autopilot을 뒷받침하고 있습니다.

### 확장성

하나의 Vault, 한 번의 리밸런싱, 모두가 혜택을 받습니다.

이것이 우리가 수백만 사용자까지 확장하는 방식입니다.

### 조합 가능성

핵심 Vault 지분 토큰은 표준 ERC-20 토큰입니다. 그래서 다음이 가능합니다.

* **담보 활용**: 핵심 Vault 지분 토큰을 Ripe Protocol에서 담보로 사용해 대출을 받을 수 있습니다. 담보가 잠겨 있어도 AI는 계속 최적화를 수행합니다
* **유동성 확보**: 유동성 풀에서 지분 토큰을 팔아 즉시 포지션을 정리할 수 있습니다
* **이동성**: 체인 간 브리지하거나 다른 프로토콜에서 활용할 수 있습니다
* **통합 용이성**: 어떤 앱이든 표준 인터페이스로 Earn Vaults를 통합할 수 있습니다

이제 사용자의 포지션은 묶인 자산이 아니라, 다른 곳에서 활용할 수 있는 조합 가능한 구성 요소가 됩니다.

### 단순함

수익을 좇는 일은 지칩니다. Morpho 금리를 확인하고, Aave 마켓을 비교하고, Euler 프로모션을 추적하고, 만료 전에 보상을 청구해야 합니다. 거의 풀타임 일입니다.

핵심 Vaults가 그 모든 것을 대신합니다. 사용자는 예치하고, 토큰을 받고, 수익을 얻습니다. 멀티프로토콜 전략, AI 리밸런싱, 리스크 관리, 보상 청구와 복리 운용 같은 복잡성은 모두 뒤에서 처리됩니다.

***

## 핵심 Vaults 작동 방식

자산을 위한 단순한 수익 최적화 레이어입니다.

### 기본 흐름

1. **예치**: USDC, ETH 또는 지원되는 다른 자산을 Vault에 예치합니다
2. **지분 토큰 수령**: 풀 지분을 나타내는 Vault 토큰(예: `_USDC`)을 받습니다
3. **AI 최적화**: 에이전트가 승인된 프로토콜, Vault, 수익 전략 전반에서 리밸런싱합니다
4. **언제든 인출**: 원할 때 지분 토큰을 상환해 기초 자산을 돌려받습니다

### AI가 하는 일

AI 에이전트는 Vault 포지션을 지속적으로 최적화합니다.

* **지속적 모니터링**: Morpho, Euler, Moonwell, Aave, Fluid, Compound 등 승인된 프로토콜 전반에서 금리, 유동성, 인센티브, 인출 조건을 감시
* **리스크 조정 라우팅**: 단순 APY를 넘어서 예치자 수, 총 예치금, 활용률, 사용 가능한 유동성을 함께 분석한 뒤 자본 이동
* **자동 리밸런싱**: 시장 조건 변화에 따라 더 나은 위험조정 수익을 포착하기 위해 자금 이동
* **보상 수확**: 프로토콜 인센티브를 자동 청구하고 복리화

### 예시: USDC 핵심 Vault

**사용자가 10,000 USDC를 예치**:

* Vault 총 자산은 1,000,000 USDC, 지분 토큰 가격은 $1.00
* 사용자는 10,000개의 `_USDC` 토큰을 받습니다

**3개월 후**:

* AI는 수십 번의 리밸런싱을 수행했습니다. 금리 기회를 포착하고, 이동 전에 리스크를 평가하고, 여러 프로모션을 활용하며, 보상이 풀리는 시점에 청구했습니다
* Vault는 이제 1,025,000 USDC를 보유합니다 (2.5% 성장)
* 사용자의 10,000 `_USDC`는 이제 10,250 USDC로 상환 가능합니다
* 사용자가 별도로 할 일은 없습니다

***

## Ripe Protocol과의 자본 효율

핵심 Vault 지분 토큰은 [Ripe Protocol](https://ripe.finance)에서 프리미엄 담보가 됩니다. 이를 통해 강력한 자본 효율이 생깁니다.

1. 핵심 Vault에 **예치**하고 `_USDC`를 받습니다
2. Ripe에서 `_USDC`를 **담보로 사용**해 스테이블코인을 빌립니다
3. **담보는 계속 수익을 냅니다**. 그동안 AI가 뒤에서 수익을 최적화합니다
4. 그렇게 빌린 스테이블코인을 다른 곳에 **배치**할 수 있습니다

사용자의 담보는 24시간 내내 일합니다. 가만히 묶여 있는 정적인 담보가 아니라, 대출을 사용하는 동안에도 적극적으로 수익을 만드는 담보입니다.

***

## Amplified Vaults

핵심 Vault 지분 토큰과 Ripe Protocol 위에 구축된 관리형 수익 증폭 구조로, 부채 안전장치도 기본 내장되어 있습니다.

### 작동 방식

Amplified Vaults는 담보를 바탕으로 대출을 일으켜 수익을 증폭합니다. 하지만 핵심 안전장치가 하나 있습니다. **빌린 자금이 항상 USD 기준 자산에 머물러야 한다**는 점입니다. 그래야 Vault가 언제나 부채를 상환할 수 있습니다. 빌린 금액은 추가 담보로 다시 Ripe에 예치되므로, 원래 자산과 빌린 USD라는 두 겹의 담보가 부채를 뒷받침하게 됩니다.

전체 흐름은 다음과 같습니다.

1. **사용자 예치**: 지원되는 기초 자산을 Underscore Amplified Vault에 예치합니다 (현재 cbBTC 또는 USDC)
2. **Vault 예치**: 그 자산을 해당 핵심 Vault에 넣습니다 (AI가 수익 최적화)
3. **담보 사용**: 그 수익형 지분 토큰을 Ripe Protocol 담보로 사용합니다
4. **대출 실행**: 그 담보를 바탕으로 GREEN(스테이블코인)을 빌립니다
5. **스왑 실행**: GREEN을 USDC로 스왑합니다
6. **재예치**: USDC를 USDC 핵심 Vault에 넣습니다 (추가 수익)
7. **추가 담보화**: 그 USDC 핵심 Vault 지분 토큰을 다시 Ripe에 추가 담보로 넣습니다

결과적으로 원래 자산도 수익을 내고, 빌린 금액도 수익을 냅니다. 단, 빌린 자금은 USD 기준 자산 안에서만 운용됩니다.

#### 수익 계산: Amplified cbBTC

$100,000 cbBTC 예치를 예로 계산해 보겠습니다.

| 레이어                 | 금액       | 금리   | 연간 수익       |
| ------------------- | -------- | ---- | ----------- |
| 핵심 Vault 안의 cbBTC   | $100,000 | 0.5% | +$500       |
| Ripe에서 대출 (LTV 70%) | $70,000  | 3%\* | -$2,100     |
| 핵심 Vault 안의 USDC    | $70,000  | 8%   | +$5,600     |
| **순수익**             |          |      | **+$4,000** |

*이 예시의 3% 차입 금리는 Ripe의 프로토콜 수준 Underscore Vault 할인에 따른 값입니다. 표준 6% 차입 금리에 50% 할인이 적용된 수치이며, 이 할인율은 설정값이라 바뀔 수 있습니다.*

원래 $100k cbBTC 기준 \*\*합산 APY는 4.0%\*\*입니다. 기본 0.5% 수익 대비 8배 향상되면서도 BTC 노출은 그대로 유지됩니다.

### 왜 USD 기반 부채가 중요한가

이 설계는 Vault를 청산으로부터 보호합니다.

* **빌린 자금은 USDC 또는 Savings GREEN으로 유지**: 빌린 자금을 BTC 같은 변동성 자산으로 바꾸지 않습니다
* **부채는 항상 상환 가능한 상태를 유지**: BTC 담보가 50% 하락해도, 빌린 USD 부분은 가치가 유지됩니다
* **연쇄 청산 구조 방지**: 빌린 금액이 가격 하락 시 손실을 증폭시키지 않습니다

**예시**: 위와 같은 $100k cbBTC 예치 상황에서

* Vault가 GREEN $70,000를 빌리고 (LTV 70%), 이를 USDC로 스왑
* cbBTC가 40% 하락 → 원래 담보 가치는 $60,000
* 하지만 빌린 $70,000는 여전히 USDC로 수익을 냄
* 그 USDC 역시 Ripe에 담보로 들어가 있으므로 총 담보는 $60k + $70k = $130k, 부채는 $70k
* 빌린 자금 가치가 유지되고, 동시에 담보에도 기여하므로 포지션은 여전히 건강한 상태를 유지

이는 빌린 돈으로 다시 변동성 자산을 사는 전통적 레버리지 포지션과 다릅니다. 그런 구조는 연쇄 청산으로 이어질 수 있습니다.

### AI가 하는 일

AI는 수익과 리스크를 함께 관리합니다.

* **담보 관리**: 자산을 핵심 Vault에 넣고, 다시 Ripe Protocol 담보로 사용합니다
* **전략적 차입**: 담보를 바탕으로 GREEN을 빌린 뒤, DEX 유동성이 좋으면 USDC로 스왑하고 아니면 Savings GREEN으로 스테이킹합니다. 어느 쪽이든 빌린 금액은 수익을 냅니다
* **USD 노출만 유지**: 빌린 자금은 USDC 또는 GREEN 같은 USD 기준 자산으로만 유지됩니다. 변동성 자산으로 절대 스왑되지 않습니다
* **부채 비율 모니터링**: 설정 가능한 최대 레버리지를 유지합니다
* **자동 디레버리징**: 비율이 한도에 가까워지면 포지션을 축소합니다

### 리스크 관리

Amplified Vaults에는 기본 안전장치가 포함됩니다.

| 제어 장치         | 목적                          |
| ------------- | --------------------------- |
| **USD 전용 차입** | 빌린 자금이 스테이블코인 노출을 유지        |
| **최대 부채 비율**  | 레버리지에 강제 상한 부여 (예: 최대 200%) |
| **자동 디레버리징**  | 비율이 한도에 가까워지면 포지션 축소        |
| **인출 안전성**    | 상환 요청 시 자동으로 레버리지 언와인딩      |
| **지속적 모니터링**  | AI가 24시간 건전성 지표를 감시         |

### 예시: Amplified cbBTC Vault

**사용자가 1 cbBTC ($100,000)를 예치**:

```
내 1 cbBTC
    ↓
cbBTC 핵심 Vault (0.5% 수익)
    ↓
핵심 Vault 지분 토큰을 Ripe에 담보로 예치
    ↓
GREEN $70,000 차입 (LTV 70%) → USDC로 스왑
    ↓
USDC 핵심 Vault (8% 수익)
    ↓
USDC 핵심 Vault 지분 토큰을 다시 Ripe에 추가 담보로 예치
```

**수익 증폭**:

* cbBTC는 cbBTC 핵심 Vault에서 0.5% 수익 → 연 +$500
* 차입 비용은 3% (할인 금리) → 연 -$2,100
* 빌린 $70k는 USDC 핵심 Vault에서 8% 수익 → 연 +$5,600
* **순수익: 4.0%**. 기본 수익 대비 8배 향상

**cbBTC가 40% 하락하면**:

* cbBTC 담보: 현재 가치 $60,000
* USDC 담보: 여전히 $70,000
* 총 담보: $130,000, 부채는 $70,000
* 포지션은 여전히 건강함. 청산 리스크 없음

**사용자의 리스크 노출**: 원래 예치한 자산(cbBTC)의 가격 움직임뿐입니다. 증폭 구조는 손실을 증폭시키지 않고 수익만 증폭시킵니다. cbBTC가 40% 하락하면, 사용자는 cbBTC를 직접 들고 있었을 때와 같은 40% 손실을 봅니다. 빌린 USD 부분은 가치가 유지되며 추가 하방 리스크를 만들지 않습니다.

***

## 핵심 Vaults vs Amplified Vaults

| 기능            | **핵심 Vaults**                          | **Amplified Vaults**                    |
| ------------- | -------------------------------------- | --------------------------------------- |
| **수익 프로필**    | 패시브 AI 관리형 수익                          | 핵심 수익 + USD 기반 차입 수익 레이어                |
| **전략 내부 대출**  | 없음                                     | 있음, Ripe Protocol 사용                    |
| **부채 노출**     | 없음                                     | 자동 디레버리징이 포함된 관리형 부채                    |
| **담보 활용 방식**  | 선택 사항: 사용자가 직접 Ripe에 지분 토큰 사용 가능       | Vault 전략 안에 기본 내장                       |
| **가장 적합한 대상** | 조합 가능한 ERC-4626 지분 토큰과 패시브 수익을 원하는 사용자 | BTC 또는 USDC 노출을 유지하면서 추가 수익 증폭을 원하는 사용자 |

***

## 예치와 지분 토큰

### 예치하기

1. Vault 컨트랙트가 사용자의 토큰을 사용할 수 있도록 승인합니다
2. 원하는 금액으로 `deposit()`을 호출합니다
3. 월렛에서 Vault 지분 토큰을 받습니다

**지분 토큰 가격 계산식**:

```
지분 토큰 가격 = Vault 총자산 / 총 발행 지분 토큰 수
```

첫 예치 시에는 지분 토큰 1개가 기초 자산 1개에 대응합니다. Vault가 수익을 내면 지분 토큰 가격이 상승합니다.

### 지분 토큰 이해하기

Vault 지분 토큰은 Vault 안의 모든 것에 대한 비례 지분을 나타냅니다.

* **지분 토큰 가격이 $1.00일 때 100개 보유** = Vault 자산에 대한 $100 청구권
* **Vault가 10% 수익 달성** = 지분 토큰 가격이 $1.10으로 상승
* **내 지분 토큰 100개의 가치가 $110이 됨** = 수익이 반영된 것

보상을 따로 청구하거나 리밸런싱할 필요가 없습니다. 지분 토큰이 Vault 성과를 자동으로 반영합니다.

### 인출하기

언제든 지분 토큰을 상환해 기초 자산을 인출할 수 있습니다.

1. 지분 토큰 수량으로 `redeem()` 또는 `withdraw()` 호출
2. AI가 필요에 따라 포지션을 자동으로 언와인딩
3. 기초 자산을 월렛으로 수령

작은 버퍼(2%)가 있어, 포지션 언와인딩 중에도 사용자가 기대한 수량을 받을 수 있도록 설계되어 있습니다.

***

## Vault 안전장치와 제어

### 승인된 프로토콜만 사용

각 Vault는 회사 정책이 아니라 스마트 컨트랙트로 강제되는 엄격한 경계 안에서만 작동합니다.

* **화이트리스트 대상 주소**: AI는 사전에 승인된 수익 프로토콜에만 자금을 예치할 수 있습니다
* **레지스트리 관리**: 승인된 프로토콜 목록은 Underscore 거버넌스가 관리합니다
* **임의 예치 불가**: AI는 승인되지 않은 대상 주소로 자금을 옮길 수 없습니다. 신뢰 문제가 아니라 코드상 불가능합니다

이 규칙은 온체인에 기록됩니다. 무분별한 거래도 없고, 실험적 팜도 없고, AI의 "환각"도 없습니다.

### 예치 제어

Earn Vaults는 추가 보호장치도 구현할 수 있습니다.

| 제어 장치        | 목적                   |
| ------------ | -------------------- |
| **예치 한도**    | 자산 집중을 막기 위한 총 자산 상한 |
| **허용 목록 모드** | 승인된 주소만 예치 허용        |
| **예치 일시 중지** | 필요 시 신규 예치 중단        |

### 비상 제어

극단적인 시장 상황에서는 다음이 가능합니다.

* **운영 동결**: 거버넌스가 모든 Vault 활동을 중단
* **인출 일시 중지**: 시장 스트레스 시 일시적 중단 (거버넌스 전용)
* **자금 보호**: 동결되어도 사용자의 지분 청구권은 계속 유효

***

## 성과 수수료

Earn Vaults는 이익에 대해서만 수수료를 부과하고, 원금에는 절대 부과하지 않습니다.

* **요율**: 발생한 수익의 20%
* **적용 대상**: 이익만, 예치 원금은 제외
* **투명한 추적**: 수수료는 지분 메커니즘과 분리되어 추적
* **예상 밖 차감 없음**: 인출 금액은 실제 자산 가치를 반영

**예시**:

* Vault가 $1,000 수익을 냄
* 20% 수수료 = $200는 프로토콜로
* $800은 지분 토큰 가격 상승을 통해 예치자에게 분배

Underscore 수익의 대부분은 이 20% 성과 수수료에서 나옵니다. Vault 사용자가 벌 때 프로토콜도 법니다. 수수료 수익의 100%는 공개 시장에서 [$RIPE](https://app.ripe.finance/ripe)를 바이백하는 데 사용됩니다.

수수료의 사용처는 [프로토콜 이코노믹스](/ko/undefined-2/protocol-economics)를 참고하세요.

***

## 핵심 Vaults vs 프로그래머블 월렛

| 기능            | **핵심 Vaults**      | **프로그래머블 월렛**     |
| ------------- | ------------------ | ----------------- |
| **소유 형태**     | 비례 지분 (토큰)         | 자산에 대한 완전한 통제     |
| **관리 방식**     | AI 관리형, 거의 손댈 일 없음 | 사용자와 매니저가 직접 결정   |
| **맞춤 설정**     | Vault별 고정 전략       | 완전한 커스터마이즈 가능     |
| **조합 가능성**    | 높음 (표준 ERC-20)     | 낮음 (자산이 월렛 안에 있음) |
| **접근성**       | 누구나 예치 가능          | 월렛 배포 필요          |
| **담보 사용**     | 가능 (지분 토큰 자체가 토큰)  | 더 복잡함             |
| **가장 적합한 대상** | 패시브 수익, 조합 가능성     | 액티브 DeFi, 맞춤 전략   |

**핵심 Vaults를 써야 할 때**: 설정 후 방치형 수익을 원하거나, 조합 가능한 생산적 담보가 필요하거나, 월렛 배포 없이 참여하고 싶을 때입니다.

**프로그래머블 월렛을 써야 할 때**: 완전한 통제권, 맞춤 전략, 에이전트 실행, 결제 자동화, 정밀한 매니저 위임이 필요할 때입니다.

***

## 현실적인 예시

### 패시브 수익 사용자

**Sarah**는 유휴 상태의 50,000 USDC를 갖고 있습니다. 수익은 원하지만 매일 금리를 확인할 시간은 없습니다.

**해결 방법**: USDC 핵심 Vault에 예치

* 즉시 `_USDC` 토큰을 받음
* AI가 Morpho, Aave, Euler 등에서 수익 기회를 포착
* `_USDC`를 Ripe 담보로 사용해 다른 기회를 위한 대출도 가능
* 담보는 대출을 받은 동안에도 계속 수익을 냄

**결과**: 생산적인 수익 + 생산적인 담보. 관리 부담은 없음.

### 핀테크 앱 통합

**PayFlow**는 사용자 잔고에 수익을 제공하고 싶은 결제 앱입니다.

**문제**: 수익 인프라를 처음부터 구축하려면 상당한 엔지니어링과 보안 감사를 감당해야 합니다.

**해결 방법**: Underscore 핵심 Vaults를 직접 통합

* 사용자는 PayFlow 인터페이스를 통해 예치
* Vault가 모든 수익 최적화를 처리
* PayFlow는 내부적으로 사용자 지분만 추적
* 표준 ERC4626 인터페이스라 통합 작업이 적음

**결과**: 수익 인프라를 직접 만들지 않고도 AI 관리형 수익 제공.

### 증폭 수익 전략

**Marcus**는 청산 리스크를 직접 관리하지 않으면서 BTC 수익을 키우고 싶습니다.

**해결 방법**: Amplified cbBTC Vault에 1 cbBTC를 예치

* cbBTC는 cbBTC 핵심 Vault에서 기본 수익을 냄
* Vault는 Ripe Protocol을 통해 cbBTC 연동 담보를 바탕으로 USDC를 차입 (70% LTV)
* 차입한 USDC는 USDC 핵심 Vault에서 추가 수익을 냄
* 차입 자금은 USD 기준 상태를 유지하므로 BTC 하락 시 하방 리스크가 증폭되지 않음
* AI가 리밸런싱과 부채 비율을 자동으로 관리

**결과**: 기본 BTC 수익 대비 약 8배 높은 수익, 하지만 리스크 노출은 BTC 가격 움직임에 한정.

***

## 자주 묻는 질문

**언제든 인출할 수 있나요?** 네. 인출은 즉시 가능합니다. Vault가 필요에 따라 포지션을 자동으로 언와인딩해 하나의 트랜잭션 안에서 요청을 처리합니다.

**Vault가 손실을 보면 어떻게 되나요?** 지분 토큰은 실제 Vault 가치를 반영합니다. 기초 자산 가치가 하락하면 지분 가격도 내려갑니다. 성과 수수료는 이익이 날 때만 부과됩니다.

**어떤 자산을 예치할 수 있나요?** 핵심 Vaults는 각기 다른 기초 자산을 지원합니다 (USDC, ETH, cbBTC, AERO, RIPE 등). Amplified Vaults는 현재 Base에서 BTC 기반 및 USDC 기반 포지션을 지원합니다.

**Vault 지분 토큰은 전송할 수 있나요?** 네. Vault 지분 토큰은 표준 ERC-20입니다. 전송, 거래, 담보 사용이 모두 가능합니다.

**최소 예치 금액이 있나요?** 프로토콜 수준의 최소 금액은 없지만, 너무 작은 금액은 가스 비용 때문에 비효율적일 수 있습니다.

***

## 시작하기

AI 최적화 수익을 시작할 준비가 되셨나요? [**앱 열기 →**](https://app.underscore.finance/)

* **바로 예치하기**: 월렛을 연결하고 핵심 Vault 또는 Amplified Vault에 예치합니다
* **프로필 선택하기**: 패시브 수익은 핵심 Vaults, Ripe 기반 두 번째 수익 레이어는 Amplified Vaults를 선택합니다
* **포지션 추적하기**: Vault 지분 토큰은 어떤 ERC-20 호환 월렛에서도 확인할 수 있습니다
* **담보로 활용하기**: 지분 토큰을 Ripe Protocol에 예치해 수익을 내는 포지션을 담보로 대출할 수 있습니다
* **언제든 인출하기**: 필요할 때 지분 토큰을 기초 자산으로 상환합니다
* **Vaults 위에 구축하기**: [기술 문서](https://underscore-1.gitbook.io/developers)를 통해 앱에 통합합니다
* **실시간 Vault 설정 확인하기**: [Params Explorer](https://params.underscore.finance/vaults)에서 현재 파라미터와 주소를 봅니다

DeFi 전략을 완전히 직접 통제하고 싶다면, 커스텀 매니저, 결제 자동화 등을 지원하는 [프로그래머블 월렛](/ko/undefined-1/user-wallet)도 살펴보세요.

***

*예치하세요. 수익을 얻으세요. 증폭하세요. 조합하세요.*


# 프로그래머블 월렛

프로그래머블 결제와 DeFi 접근을 지원하는 스마트 컨트랙트 월렛 — 수탁 없이 실행 권한만 부여

대부분의 에이전트는 추천만 할 수 있습니다. Underscore는 프라이빗 키를 넘기지 않고도 실제 자금으로 실행하게 만듭니다.

Underscore 프로그래머블 월렛은 AI 에이전트와 운영자가 온체인 규칙 안에서 실행할 수 있도록 설계된 스마트 컨트랙트 월렛입니다. [매니저](/ko/undefined-1/managers)는 권한을 정의하고, [수취인](/ko/undefined-1/payees)은 반복 지출을 처리하며, [디지털 수표](/ko/undefined-1/cheques)는 선택적 검토 지연이 있는 일회성 결제를 처리합니다. 모든 것은 오픈소스 스마트 컨트랙트에 의해 온체인에서 강제됩니다.

하나의 주소로 20개 이상의 DeFi 프로토콜에 접근할 수 있습니다. 엄격한 경계 안에서 에이전트에게 운영을 위임할 수 있습니다. 자금이 수익을 내는 동안 결제를 자동화할 수 있습니다. 서로 다른 월렛 사이로 자본을 즉시 이동할 수도 있습니다.

Base L2 위에 구축된 이 월렛은 기관급 보안성과 24시간 기회를 포착할 수 있는 유연성을 함께 제공합니다. 에이전트가 자율적으로 실행하든, 사용자가 직접 관리하든 마찬가지입니다.

핵심 구성은 네 가지입니다.

1. **통합 프로토콜 접근**: 표준화된 어댑터를 통해 주요 DeFi 프로토콜에 직접 연결
2. **에이전트 실행**: [매니저](/ko/undefined-1/managers)가 정의된 경계 안에서 전략 실행. 수탁 없음, 키 공유 없음
3. **결제 레일**: 반복 지출과 일회성 승인용 프로그래머블 결제 시스템 ([수취인](/ko/undefined-1/payees), [수표](/ko/undefined-1/cheques))
4. **보안 계층**: 타임락, 화이트리스트, 세분화된 권한으로 모든 작업 보호

## 하나의 월렛, 모든 프로토콜

Underscore는 "DeFi 레고"라고 부르는 표준화된 어댑터를 통해 DeFi 프로토콜에 연결됩니다. 각 레고는 프로토콜별 작업을 일관된 인터페이스로 감싸며, 최적화된 가스 사용량으로 원자적 멀티프로토콜 트랜잭션을 가능하게 합니다.

**이 월렛은 시간이 지나도 계속 활용할 수 있습니다**. 새로운 DeFi 프로토콜이 출시되거나 기존 프로토콜에 기능이 추가되면, 새 DeFi 레고 통합을 통해 자동으로 월렛에 반영됩니다. 자금을 옮길 필요도, 새 월렛을 배포할 필요도, 따로 업데이트할 필요도 없습니다. 새 레고가 배포되는 순간 기존 프로그래머블 월렛도 곧바로 새 프로토콜에 접근할 수 있습니다.

### 수익 및 대출 프로토콜

**통합 프로토콜**: Morpho, Moonwell, Aave, Euler, Fluid, Compound, 그리고 Avantis, ExtraFi 같은 특화 프로토콜 외 다수

**가능한 작업**:

* 자산 예치로 수익 창출
* 자동 언와인딩을 포함한 자금 인출
* 수익 추적과 이익 계산
* 프로토콜 보상 청구
* 프로토콜 간 리밸런싱

### 트레이딩 및 DEX 통합

**통합 DEX**: Aerodrome, Uniswap, Curve

**가능한 작업**:

* 스마트 라우팅 기반 토큰 스왑 (최대 5홉 경로)
* 자동 비율 계산을 통한 유동성 추가/제거
* 표준 유동성(uni v2)과 집중 유동성(uni v3+) 모두 지원
* NFT 포지션 관리 및 범위 조정

### 부채 관리

**통합 프로토콜**: [Ripe Protocol](https://ripe.finance)

Ripe Protocol은 Underscore의 대출 파트너로, 자산을 팔지 않고도 유동성을 확보할 수 있게 해줍니다. 핵심 장점은 **Underscore 핵심 Vault 지분 토큰이 담보로 인정된다는 점**입니다. 즉, 자산이 AI 최적화 수익을 내는 동안 그 자산을 담보로 대출도 받을 수 있습니다. 수익과 유동성 중 하나를 고르는 것이 아니라 둘 다 가져갈 수 있습니다. Amplified Vaults도 Vault 전략 내부에서 같은 패턴을 활용합니다.

**작동 방식**:

1. **담보 예치**: 자산을 Ripe Protocol에 잠급니다. Underscore 핵심 Vault 지분 토큰도 포함됩니다
2. **대출 실행**: GREEN(스테이블코인) 또는 수익형 sGREEN으로 대출받습니다
3. **수익 유지**: 핵심 Vault 지분 토큰을 담보로 쓰는 경우, 기초 자산은 계속 최적화 수익을 창출합니다
4. **언제든 상환**: 원하는 시점에 원금과 이자를 갚습니다
5. **담보 회수**: 부채가 정리되면 자산을 인출합니다

**왜 중요한가요?**

기존 대출은 보통 선택을 강요합니다. 수익을 얻거나, 자산을 담보로 쓰거나 둘 중 하나입니다. Underscore + Ripe에서는:

* 핵심 Vault에 예치해 AI가 수익을 최적화하게 합니다
* 그 핵심 Vault 지분 토큰을 Ripe에서 담보로 사용합니다
* GREEN/sGREEN을 대출받아 유동성을 확보합니다
* 담보는 그동안 계속 수익을 냅니다

**가능한 작업**:

* 지원되는 어떤 자산이든 담보로 예치
* Underscore 핵심 Vault 지분 토큰을 수익 창출형 담보로 활용
* GREEN(스테이블코인) 또는 sGREEN(수익형 스테이블코인) 대출
* 허용된 어떤 토큰으로든 부채 상환
* 부채 포지션에서 RIPE 보상 획득 및 청구

**매니저 권한**:

* **부채 관리**: 담보 추가/제거, 대출, 상환
* 매니저는 대출한 자금을 외부 주소로 인출할 수 없습니다
* 모든 작업은 기본 매니저 한도를 따릅니다

**왜 대출하나요?**

* 오를 수 있는 자산을 팔지 않고도 유동성 확보
* 담보에서 계속 수익 창출
* 세금 효율성 향상. 대출은 일반적으로 과세 이벤트가 아님
* 단기 현금 흐름 수요 대응

### 자산 변환

**가능한 작업**:

* 슬리피지 없이 ETH ↔ WETH 변환
* 예치 증표 토큰(receipt token) 발행 및 상환 (예: stETH)
* 지연 상환 처리
* 프로토콜 요구사항에 맞춘 자동 포맷 변환

### 보상 및 인센티브

**가능한 작업**:

* 모든 프로토콜 보상을 하나의 트랜잭션으로 일괄 청구
* 생산적인 포지션으로 보상을 자동 복리
* 프로토콜 전반의 누적 수익 추적

## 배치 작업: 여러 단계, 하나의 트랜잭션

Underscore의 아키텍처는 복잡한 다단계 작업을 하나의 트랜잭션 안에서 원자적으로 실행할 수 있게 합니다. 이는 상당한 가스 절감 효과를 제공하고, 일부 단계만 실행되는 부분 실패 위험도 제거합니다.

### 배치 작업 예시

**수익 리밸런싱**:

```
1. Aave에서 인출 (낮은 수익)
2. Morpho에 예치 (높은 수익)
3. 두 프로토콜 모두에서 보상 청구
4. 보상을 생산적인 자산으로 변환
→ 전부 하나의 트랜잭션으로 처리
```

**복합 포지션 진입**:

```
1. Ripe Protocol에 담보 예치
2. 담보를 바탕으로 대출
3. 대출한 자금을 유동성으로 공급
4. 추가 수익을 위해 LP 토큰 스테이킹
→ 한 번의 클릭으로 전략 전체 실행
```

**포트폴리오 리밸런싱**:

```
1. 여러 풀에서 유동성 제거
2. 목표 비중에 맞게 자산 스왑
3. 새 포지션에 재배치
4. 모든 [보상](rewards.md) 청구 및 재투자
→ 전체 리밸런싱을 원자적으로 처리
```

## 스왑: 어떤 토큰이든 거래

프로그래머블 월렛에서 토큰을 스왑하면, 시스템이 통합된 DEX 전반에서 가장 나은 경로를 찾습니다.

### 스왑 작동 방식

멀티홉 라우팅 예시:

```
USDC → PEPE로 스왑하고 싶다고 가정해 봅시다.
직접 경로가 없거나 유동성이 부족할 수 있습니다.

스마트 라우팅은 다음과 같은 경로를 찾습니다:
USDC → ETH → PEPE (2홉)
또는
USDC → WETH → PEPE (더 나은 가격의 2홉)

최적 가격을 위해 최대 5홉까지 지원합니다.
```

### 슬리피지 보호

모든 스왑에는 슬리피지 보호가 포함됩니다. 사용자가 받을 최소 수량을 지정하면, 시장 상황이 바뀌어 그보다 적게 받게 되는 경우 트랜잭션은 되돌려집니다.

* 월렛 기본값: 스왑별로 설정 가능
* 매니저 한도: 각 매니저에는 최대 슬리피지 상한이 있습니다 (예: 최대 1%)
* 안전장치: 나쁜 가격으로 체결되는 대신 트랜잭션을 되돌립니다

### 스왑 수수료

Underscore는 스왑에 0.25% 수수료를 부과합니다. 이는 DEX 수수료와는 별개이며, DEX 수수료는 유동성 공급자에게 갑니다.

스왑 수수료는 Underscore의 비교적 작은 수익원 중 하나입니다. 다른 프로토콜 수익과 마찬가지로, 이 수익도 공개 시장에서 [$RIPE](https://app.ripe.finance/ripe)를 바이백하는 데 사용됩니다.

### 매니저 스왑 제어

매니저가 스왑을 실행할 때는 추가 제어가 적용됩니다.

* 최대 슬리피지 비율
* 기간별 최대 스왑 횟수
* 스왑당 최소 USD 금액
* 자산 제한 (어떤 토큰을 스왑할 수 있는지)

***

## 유동성 공급: 거래 수수료로 수익 창출

프로그래머블 월렛을 사용하면 탈중앙화 거래소에 유동성을 공급하고 거래 수수료의 일부를 벌 수 있습니다. 이는 가장 강력한 DeFi 전략 중 하나입니다. 사용자의 자산이 다른 사람의 거래를 가능하게 하면서 일하게 됩니다.

### 작동 방식

유동성을 공급할 때는 USDC와 ETH처럼 두 종류의 토큰을 거래 풀에 예치합니다. 트레이더는 이 토큰 사이를 스왑하며 수수료를 지불하고, 사용자는 풀 지분에 비례해 그 수수료를 받습니다.

**기본 예시**:

```
예치 자산: $5,000 USDC + $5,000 상당 ETH
풀 지분: 전체 유동성의 1%
일일 거래량: $1,000,000
수수료율: 0.3%
일일 수익: $30 (0.3% × $1M × 1%)
```

### 두 가지 유동성 유형

**단순 유동성 (Uniswap V2 스타일)**

* 가치가 같은 두 토큰을 예치
* 모든 가격 구간에서 수수료 획득
* 지분을 나타내는 LP 토큰 수령
* 지원 대상: Aerodrome Classic, Uniswap V2, Curve

**집중 유동성 (Uniswap V3 스타일)**

* 유동성을 제공할 구체적인 가격 범위 선택
* 가격이 해당 범위 안에 있을 때 더 높은 수수료 획득
* 자본 효율이 높지만 모니터링 필요
* 대체 가능 토큰이 아닌 NFT 포지션을 수령
* 지원 대상: Aerodrome Slipstream, Uniswap V3

### LP에 대한 매니저 권한

매니저는 **유동성 관리** 권한으로 유동성 작업을 처리할 수 있습니다.

* 승인된 풀에 유동성 추가
* 리밸런싱 시 유동성 제거
* 모든 기본 매니저 한도 적용

### 알아야 할 위험

**비영구적 손실**: 토큰 가격이 크게 벌어지면, 단순 보유했을 때보다 가치가 줄어들 수 있습니다. 이 손실은 출금할 때 비로소 "영구적"이 됩니다.

**스마트 컨트랙트 리스크**: LP 포지션은 DEX 스마트 컨트랙트 안에 존재합니다. Underscore는 검증되고 감사를 받은 프로토콜만 통합합니다.

***

## 그 밖의 월렛 기능

### Eject Mode: 긴급 락다운

월렛이 손상되었을 수 있다고 의심되거나 즉시 활동을 제한해야 한다면, Eject Mode를 활성화해 작업을 잠글 수 있습니다.

**활성화 시**:

* 전송과 ETH/WETH 변환만 허용
* 수익, 스왑, 부채, 유동성 작업은 모두 금지
* 오직 소유자만 어떤 작업이든 수행 가능
* 모든 매니저는 작동이 차단됨

**사용 예시**:

```
의심스러운 활동 감지
    ↓
Eject Mode 활성화 (트랜잭션 1회)
    ↓
월렛이 기본 작업만 가능한 상태로 잠김
    ↓
화이트리스트 주소로 자금을 안전하게 이동
    ↓
안전이 확보되면 Eject Mode 해제
```

Eject Mode는 비상시를 위한 패닉 버튼입니다. 먼저 제한하고, 나중에 조사하면 됩니다.

### [매니저](/ko/undefined-1/managers): 에이전트에게 실행 권한을 부여하되, 수탁 권한은 주지 않습니다

매니저는 승인된 운영자(사람이든 AI이든)로, 사용자가 정의한 경계 안에서 작업을 실행합니다. 거래하고, 수익을 최적화하고, 결제를 관리할 수 있지만, 외부 주소로 출금하거나 한도를 초과할 수는 없습니다.

**사용 사례**:

* AI 에이전트가 24시간 수익 최적화 수행
* 트레이딩 에이전트가 데이터 피드, 컴퓨트, 추론 API 비용 지불
* 부채 포지션의 자동 관리
* CFO가 벤더 및 외주 인력 결제 처리
* 전문 트레이더가 포트폴리오 일부 관리
* 가족 구성원에게 긴급 접근 권한 부여

[→ 매니저 자세히 보기](/ko/undefined-1/managers)

### [수취인](/ko/undefined-1/payees): 에이전트가 필요한 서비스 비용을 결제하도록 합니다

수취인(Payee)은 반복 지출 계층입니다. 미리 승인된 수취인으로, 사용자가 허용한 범위 안에서만 자금을 받을 수 있습니다. 시장 데이터 피드, 모델 제공자, 컴퓨트 벤더, 외주 인력, 급여, 구독에 사용하세요. 자금은 결제 시점까지 수익을 내다가, 필요할 때 자동으로 전송됩니다.

**사용 사례**:

* 에이전트용 데이터 피드 및 추론 API 구독
* 주간 예산이 있는 컴퓨트 벤더 결제
* 수익을 내는 자금에서 직원 급여 지급
* 벤더 및 외주 인력에 대한 자동 결제
* 풀 결제(Pull Payment)를 활용한 구독형 서비스

[→ 수취인 자세히 보기](/ko/undefined-1/payees)

### [수표](/ko/undefined-1/cheques): 무조건적인 신뢰 없이 처리하는 일회성 지출

디지털 수표는 자금 이체를 통제 가능한 결제 약속으로 바꿉니다. 소액은 즉시 처리됩니다. 큰 금액은 검토 지연 뒤에 놓이고, 언제든 취소할 수 있습니다. 자금은 실제 결제 전까지 계속 수익을 냅니다.

**사용 사례**:

* 에이전트가 일회성 데이터셋이나 컴퓨트 작업 구매
* 결과물이 오지 않으면 취소할 수 있는 외주 결제
* 검토 시간이 내장된 대규모 전송
* 결제 시점을 유연하게 조절할 수 있는 일회성 벤더 송장
* "되돌리기" 옵션이 필요한 어떤 결제든

[→ 수표 자세히 보기](/ko/undefined-1/cheques)

### [화이트리스트](/ko/undefined-1/whitelist): 무제한 신뢰

화이트리스트는 비상시를 위해 준비해 두는 최고 신뢰 단계입니다. 지연이나 한도 없이 무제한 전송을 받을 수 있는 주소 목록입니다. 타임락 추가는 월렛 손상을 방어하고, 즉시 제거는 통제권을 유지하게 합니다.

**사용 사례**:

* 긴급 자금 접근용 하드웨어 월렛
* 즉시 자금 통합이 필요한 기업 재무 월렛
* 리스크 분산을 위한 멀티월렛 전략
* 접근을 잃어버렸을 때 복구용 Gnosis Safe

[→ 화이트리스트 자세히 보기](/ko/undefined-1/whitelist)

## 아키텍처 비교

| 기존 다중 월렛 구성      | Underscore 프로그래머블 월렛 |
| ---------------- | -------------------- |
| 여러 인터페이스와 로그인 필요 | 하나의 통합 인터페이스         |
| 프로토콜마다 수동 토큰 승인  | 사전 구성된 프로토콜 접근       |
| 월렛 간 외부 전송 필요    | 내부 라우팅, 별도 전송 불필요    |
| 수동 수익 추적         | 자동 이익 계산             |
| 자동화 옵션이 제한적      | 완전한 위임 기능            |
| 월렛별로 분리된 보안      | 통합 보안 모델             |

## 자주 묻는 질문

### 🔐 **보안 및 통제**

**이건 셀프 커스터디 월렛인가요?**\
네. 소유자 지갑과 자산에 대한 최종 통제권은 사용자에게 있습니다. 매니저는 온체인에서 승인된 제한된 작업만 실행할 수 있으며, 수탁 권한이나 무제한 서명 권한을 절대 받지 않습니다.

**Underscore가 사라지면 어떻게 되나요?**\
자금은 계속 안전하고 접근 가능합니다. 스마트 컨트랙트는 불변이며 Underscore 서버에 의존하지 않습니다. BaseScan이나 다른 인터페이스를 통해 직접 월렛과 상호작용할 수 있습니다. [Params Explorer](https://params.underscore.finance/deployments)에서는 현재 배포 상태와 프로토콜 설정도 확인할 수 있습니다.

**새 월렛으로 마이그레이션할 수 있나요?**\
네. 프로토콜에는 자금 이동과 설정 복사(매니저, 수취인, 화이트리스트)를 지원하는 마이그레이션 시스템이 포함되어 있습니다. 새 기능을 쓰고 싶거나 구성을 재정비해야 할 때 유용합니다.

### 💰 **비용 및 수수료**

**수수료는 어떻게 되나요?**

* **Earn Vault 성과 수수료**: 발생한 수익금에 대해서만 20%
* **스왑 수수료**: 토큰 스왑 시 0.25%
* **외부 보상 청구**: 프로토콜 보상(MORPHO, WELL 등) 청구 시 20%
* **수익 사용처**: 프로토콜 수익의 100%는 공개 시장에서 [$RIPE](https://app.ripe.finance/ripe)를 바이백하는 데 사용됩니다
* **수수료 없음**: 전송, 유휴 자금, 예치, 부채 작업, 유동성 공급, ETH/WETH 래핑

수수료 구조와 사용처는 [프로토콜 이코노믹스](/ko/undefined-2/protocol-economics)를 참고하세요.

### 기술 설정

**기존 월렛과 함께 사용할 수 있나요?**\
네. 기존 월렛(예: MetaMask)으로 Underscore 프로그래머블 월렛을 배포하면, 그 기존 월렛이 소유자 지갑 역할을 하게 됩니다.

**어떤 프로토콜에 접근할 수 있나요?**\
Aave, Morpho, Compound(대출), Ripe Protocol(차입), Uniswap, Curve, Aerodrome(거래) 등 20개 이상의 프로토콜에 접근할 수 있습니다. 새 프로토콜도 레고 시스템을 통해 자동으로 통합됩니다.

**Base L2에 문제가 생기면 어떻게 되나요?**\
Base는 Ethereum의 보안 모델을 상속합니다. 매우 드문 경우 L2 이슈가 발생하더라도 자산을 Ethereum 메인넷으로 인출하기 위한 확립된 절차가 존재합니다. 자금에 대한 통제권은 계속 사용자에게 있습니다.

***

## 당신의 선택

AI 에이전트에게 필요한 것은 API만이 아닙니다. 제한된 온체인 실행 권한, 프로그래머블 결제 레일, 그리고 강력한 보안 한도가 필요합니다.

에이전트나 운영자가 리밸런싱하고, 결제하고, 대출하고, 상환하고, 사용자가 정한 규칙 안에서 자금을 이동해야 한다면 프로그래머블 월렛을 배포하세요.

***

*프로그래머블 월렛 + Earn Vaults. 당신의 돈은 잠들지 않습니다.*


# 매니저

사용자가 통제하는 깨지지 않는 경계 안에서 에이전트에게 실행 권한만 부여하고 수탁 권한은 주지 않습니다

대부분의 에이전트는 추천만 할 수 있습니다. Underscore는 프라이빗 키를 절대 넘기지 않고도 실제 자금으로 실행하게 만듭니다.

매니저는 [프로그래머블 월렛](/ko/undefined-1/user-wallet)을 대신해 전략을 실행하고 결제를 처리하는 승인된 운영자입니다. 하지만 완전한 통제권은 절대 갖지 않습니다. 예를 들어 "USDC는 최대 $50k까지 거래하되 ETH는 건드리지 마라", "Aave, Morpho, Euler, Compound 사이에서만 리밸런싱하라", "$10k는 일일 한도, $100k는 월간 한도"처럼 정확한 권한을 설정할 수 있습니다. 자동 만료되는 시간 기반 제어를 넣을 수도 있고, 원하면 한 번의 클릭으로 즉시 권한을 철회할 수도 있습니다.

새벽 3시에 AI 에이전트가 수익 스파이크를 잡도록 둘 수 있습니다. 트레이딩 에이전트가 데이터 피드와 컴퓨트 비용을 스스로 결제하게 할 수도 있습니다. CFO가 준비금에는 손대지 않고 벤더 송장을 처리하게 할 수도 있습니다. 트레이더가 정해진 경계 안에서 특정 포지션만 운영하게 할 수도 있습니다. 모든 동작은 사용자가 정한 규칙에 따라 온체인에서 검증됩니다.

## 매니저가 필요한 이유

### 에이전트 문제

AI 에이전트는 실제 돈으로 트랜잭션을 실행해야 합니다. 수익 포지션을 리밸런싱하고, 데이터 피드를 결제하고, 컴퓨트 리소스를 구매해야 합니다. 하지만 에이전트에게 프라이빗 키나 무제한 접근 권한을 주는 것은 받아들일 수 없는 리스크입니다. 기존 API 키나 월렛 위임에는 온체인 강제력이 없습니다. 버그 한 번, 익스플로잇 한 번이면 모든 것이 사라질 수 있습니다.

매니저는 스마트 컨트랙트가 강제하는 경계 안에서 실행 권한을 부여함으로써 이 문제를 해결합니다. 에이전트는 사용자가 승인한 것만, 그보다 많지도 적지도 않게 수행할 수 있습니다. 예산, 자산 제한, 프로토콜 제한, 만료 창은 정책이 아니라 코드로 강제됩니다.

### 수동 월렛 관리의 문제

[프로그래머블 월렛](/ko/undefined-1/user-wallet)을 혼자 운영하면 피할 수 없는 트레이드오프가 생깁니다.

* **24시간 기회**: DeFi는 쉬지 않지만 사람은 쉽니다
* **반복 작업**: 벤더 결제, [보상 청구](/ko/undefined-2/rewards), 리밸런싱은 시간이 계속 들어갑니다
* **전문성 요구**: 복잡한 전략은 사용자가 갖고 있지 않을 수 있는 전문 지식을 요구합니다
* **긴급 접근**: 사용자에게 무슨 일이 생기면 자금이 묶일 수 있습니다

기존 해법은 모두 어딘가에서 실패합니다.

* **공유 키**: 키 하나만 손상돼도 전부 잃을 수 있습니다
* **멀티시그**: 모든 트랜잭션에 조율이 필요해 느립니다
* **수탁 서비스**: 통제권을 잃고 수수료도 높습니다

### 매니저 해법

매니저는 정밀한 제어가 가능한 프로그래머블 위임을 제공합니다.

* **제한된 권한**: 특정 작업만 허용합니다 (대출, 토큰 스왑, [수취인](/ko/undefined-1/payees) 결제 등)
* **지출 한도**: 트랜잭션당 및 기간당 금액에 강제 상한을 둡니다
* **자산 제한**: 매니저가 다룰 수 있는 토큰을 제한합니다
* **즉시 철회**: 트랜잭션 한 번으로 접근 권한을 제거합니다
* **시간 지연**: 민감한 작업에는 선택적 쿨다운(cooldown)을 설정할 수 있습니다

### 2단계 보안 검사

모든 매니저 작업은 자동 검증을 거칩니다.

**작업 전 검사**:

* ✓ 이 매니저는 아직 활성 상태인가?
* ✓ 이 특정 작업을 수행할 수 있는가?
* ✓ 이 자산을 다룰 수 있는가?
* ✓ 승인된 프로토콜을 사용하고 있는가?
* ✓ 마지막 작업 이후 충분한 시간이 지났는가?

**작업 후 검사**:

* ✓ 트랜잭션당 한도를 넘지 않았는가?
* ✓ 일일/주간/월간 예산 안에 아직 남아 있는가?
* ✓ 전체 생애 한도를 초과하지 않았는가?

두 단계 모두 트랜잭션 안에서 원자적으로 실행됩니다. 어느 하나라도 실패하면 전체 작업이 되돌려집니다.

## 권한: 매니저가 할 수 있는 일

권한은 매니저에게 부여하는 세분화된 기능 단위입니다. 벤더 결제만 하는 CFO부터 전체 DeFi 전략을 관리하는 AI까지, 필요한 운영자 프로필을 정확히 만들 수 있도록 권한을 조합할 수 있습니다. 각 권한은 독립적이며 다른 권한과 함께 사용할 수 있습니다.

### 전송 및 결제 작업

| 권한                                          | 기능                                                                                                                 | 예시 사용 사례     |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------ |
| **일반 전송**                                   | [수취인](/ko/undefined-1/payees), [화이트리스트](/ko/undefined-1/whitelist), 또는 [디지털 수표](/ko/undefined-1/cheques)를 통한 자산 전송 | 월간 지출 결제     |
| [**수표**](/ko/undefined-1/cheques) **생성**    | 일회성 결제 예약                                                                                                          | 지연이 있는 벤더 결제 |
| [**수취인**](/ko/undefined-1/payees) **추가 제안** | 반복 결제 수취인 추가 제안                                                                                                    | 새 외주 인력 온보딩  |

### DeFi 작업

| 권한         | 기능                | 예시 사용 사례                                  |
| ---------- | ----------------- | ----------------------------------------- |
| **매수·매도**  | 토큰 스왑, 포트폴리오 리밸런싱 | ETH/USDC 60/40 비중 유지                      |
| **수익 관리**  | 수익 프로토콜에 예치/인출    | Morpho/Aave 포지션 리밸런싱                      |
| **부채 관리**  | 대출과 담보 관리         | 담보비율 150% 유지                              |
| **유동성 관리** | DEX 유동성 공급/회수     | Uniswap V3 범위 최적화                         |
| **보상 청구**  | 프로토콜 인센티브 수확      | [파밍 보상](/ko/undefined-2/rewards) 청구 및 재투자 |

### 관리 작업

| 권한             | 기능                 | 예시 사용 사례                                |
| -------------- | ------------------ | --------------------------------------- |
| **화이트리스트 관리**  | 승인된 주소 추가/제거       | 벤더 목록 관리                                |
| **프로토콜 보상 청구** | Underscore 인센티브 청구 | [플랫폼 보상](/ko/undefined-2/rewards) 자동 청구 |
| **Loot 청구**    | 수익 공유 회수           | [프로토콜 수익](/ko/undefined-2/rewards) 극대화  |

> **📝 Underscore의 시간 단위**\
> 모든 시간 기반 설정(지연, 쿨다운, 기간)은 실제 시계 시간이 아니라 블록 수로 저장됩니다. Base L2에서 블록 타임을 2초로 가정하면:
>
> * 1시간 (1,800 블록)
> * 1일 (43,200 블록)
> * 1주 (302,400 블록)
>
> 이 가이드의 예시는 Base의 2초 블록 타임을 기준으로 합니다.

## 제어 장치: 보안 경계

권한이 매니저가 무엇을 할 수 있는지 정한다면, 제어 장치는 그들이 어디까지 움직일 수 있는지 정합니다. 이 한도 덕분에 신뢰하는 매니저라 해도 사용자의 리스크 허용 범위를 넘거나, 실수나 악의적인 행동으로 월렛을 비우는 일은 불가능합니다. 모든 매니저 작업은 이런 보안 체크포인트를 통과해야 합니다.

### 재무 한도

**트랜잭션당 한도**

* 단일 트랜잭션에 허용되는 최대 USD 금액
* 예: $5,000 상한으로 한 번의 큰 손실 방지

**기간 기반 한도**

* 반복되는 시간 창 안에서 허용되는 총 USD 금액
* 기간 길이는 글로벌 설정의 `managerPeriod`로 지정합니다 (예: 1일 = 43,200 블록)
* 현재 기간이 끝나면 자동으로 초기화됩니다
* 예: 트레이딩 작업에 대해 하루 $10,000 한도

```
1주차: $10k 한도 중 $7k 사용 → 2주차: 다시 $10k 한도
남은 금액은 이월되지 않습니다. 각 기간은 새로 시작합니다
```

**생애 한도**

* 매니저가 활동하는 전체 기간 동안의 누적 USD 상한
* 예: 1년짜리 AI 서비스에 총 $500,000 한도

### 운영 제어

**트랜잭션 쿨다운**

* 트랜잭션 사이에 반드시 기다려야 하는 시간
* 블록 수로 측정됩니다 (예: Base에서 1시간 = 1,800 블록)
* 빠른 연속 실수나 공격을 막아 줍니다

**자산 제한**

* 매니저를 특정 토큰만 다루도록 제한합니다 (예: 스테이블코인만)
* 어떤 자산을 건드릴 수 있는지 세밀하게 제어합니다
* 매니저당 최대 40개 자산

**프로토콜 제한 (레고)**

* 특정 DeFi 프로토콜 ID로 제한합니다
* 각 프로토콜([레고](/ko/undefined-1/user-wallet) = Aave, Curve 등과의 표준화된 통합)은 LegoBook에 등록됩니다
* 예: Aave와 Compound 상호작용만 허용
* 매니저당 최대 25개 프로토콜

**승인된 수익 프로토콜만 허용**

* 수익 예치를 승인된 Vault 지분 토큰으로만 제한합니다
* 위험하거나 검증되지 않았거나 알 수 없는 프로토콜로의 예치를 막습니다
* 프로토콜의 VaultRegistry 화이트리스트를 통해 관리됩니다
* `onlyApprovedYieldOpps` 설정으로 활성화합니다

**수취인 제한**

* 미리 승인된 수취인 주소로만 전송을 허용합니다
* 알려진 벤더만 상대하는 비즈니스 운영에 적합합니다
* 매니저당 승인된 [수취인](/ko/undefined-1/payees) 최대 40개

**0 가격 시 실패 처리**

* 자산 가격이 $0일 때 트랜잭션을 막는 안전 기능
* 오라클 장애 시 거래를 방지합니다
* 가격 정보가 없을 때의 조작 위험을 줄여 줍니다

### 스왑 제어

과도한 손실과 조작을 막기 위해, 전용 스왑 제어를 통해 트레이딩 활동을 세밀하게 제한할 수 있습니다.

| 설정              | 목적                    | 예시             |
| --------------- | --------------------- | -------------- |
| **최대 슬리피지**     | 스왑에서 허용할 최대 가격 변동     | 기본값: 최대 5%     |
| **기간당 최대 스왑 수** | 거래 빈도 제한              | 기본값: 하루 2회     |
| **USD 가치 요구**   | 두 토큰 모두 가격 데이터가 있어야 함 | 가격 없는 토큰 거래 방지 |

**슬리피지 보호 작동 방식**:

각 스왑 전에 시스템은 사용자가 설정한 슬리피지 한도를 기준으로 최소 허용 수령량을 계산합니다. 실제 결과가 이 기준보다 낮아지면 트랜잭션은 자동으로 되돌려집니다.

```
예시: 최대 슬리피지 5%로 $1,000 USDC → ETH 스왑
최소 허용 수량: $950 상당의 ETH
DEX가 $940 상당만 돌려준다면 → 트랜잭션 되돌림
```

이 기능은 다음을 방어합니다.

* MEV 샌드위치 공격
* 실행 중 가격 조작
* 극심한 시장 변동성
* 실수로 체결되는 나쁜 거래

시스템은 글로벌 설정과 매니저 개별 설정 중 더 엄격한(더 낮은) 한도를 적용합니다.

### 시간 기반 보안

**활성화 지연**

* 새 매니저는 권한이 활성화되기 전 일정 시간을 기다립니다
* 사용자가 설정하는 지연 기간 (예: 1시간, 1일, 1주)
* 추가가 의심스러울 경우 검토하고 취소할 시간을 줍니다
* 성급하거나 악의적인 매니저 추가를 방어합니다

**활성 기간**

* 매니저 만료 시점을 설정할 수 있습니다
* 예: 30일(체험), 90일(분기), 365일(연간) 후 자동 만료
* 별도 조치 없이 권한이 자동으로 종료됩니다

### 글로벌 설정 vs 개별 설정

Underscore는 항상 더 제한적인 설정이 우선하는 이중 레이어 구성 방식을 사용합니다.

**글로벌 매니저 설정**

* 월렛의 모든 매니저에 적용되는 기본 템플릿
* 어떤 매니저도 넘을 수 없는 최대 경계를 설정
* 사용자가 한도 적용 대상인지 결정하는 `canOwnerManage` 플래그 포함

**개별 매니저 설정**

* 매니저별 개별 구성
* 글로벌보다 더 엄격할 수는 있지만, 덜 엄격할 수는 없습니다
* 어떤 작업이든 글로벌과 개별 설정이 모두 허용해야 실행됩니다

```
예시: 권한 계층
글로벌: 거래 가능 = 예, 트랜잭션당 최대 = $100k
매니저 A: 거래 가능 = 예, 트랜잭션당 최대 = $50k → 실제 한도는 $50k
매니저 B: 거래 가능 = 아니오, 트랜잭션당 최대 = $200k → 거래 자체 불가
```

## 실제 사용 예시

### 수익 최적화

**설정**: YieldMaxAI Agent가 관리하는 $100k 스테이블코인

**권한**:

* 자산: 스테이블코인만 (USDC, USDT, DAI)
* 프로토콜: Aave, Morpho, Euler만
* 한도: 트랜잭션당 $20k, 6시간 쿨다운

**결과**:

* 새벽 3시에 Morpho의 5.2% 금리를 포착
* Euler의 6.1% 프로모션 금리로 이동
* 놓치고 있던 [보상/인센티브](/ko/undefined-2/rewards) $312 자동 청구
* 연간 추가 수익: $3,000

### 에이전트 서비스 결제

**설정**: 실시간 데이터 피드, 추론 API, 컴퓨트가 필요한 트레이딩 에이전트

**권한**:

* 일반 전송: 승인된 [수취인](/ko/undefined-1/payees)으로만 전송
* [수표](/ko/undefined-1/cheques) 생성: 일회성 데이터 구매용
* 자산: USDC만
* 한도: 트랜잭션당 $500, 월 $5,000
* 쿨다운: 결제 간 1시간

**결과**:

* 에이전트가 데이터 피드, 추론 API, GPU 제공자를 계속 가동
* 소규모 데이터셋 구매($3-$50)는 디지털 수표로 즉시 처리
* 모든 지출은 추적, 상한 적용, 철회 가능
* 에이전트는 수탁 권한, 프라이빗 키, 무제한 접근을 절대 받지 않음

### 비즈니스 운영

**설정**: 30명 이상의 외주 인력과 벤더를 둔 글로벌 크립토 기업, CFO를 매니저로 지정

**권한**:

* 수취인: 미리 승인된 외주 인력 및 벤더 주소만
* 한도: 결제당 $2,500, 주간 $25,000
* 쿨다운: 결제 간 1시간
* 자산: USDC만

**결과**:

* CFO가 벤더 결제를 독립적으로 처리
* 매월 $1,750의 송금 수수료 절감
* 소유자는 결제 업무에서 벗어남
* 투자 자금은 계속 손대지 못하도록 보호

### 패밀리 오피스 트레이딩

**설정**: 전문 트레이더 5명을 각각 매니저로 지정

**트레이더별 권한**:

* 자산: ETH, BTC, 스테이블코인
* 프로토콜: 주요 DEX만
* 한도: 거래당 $100k, 트레이더별 일일 상한 $500k
* 기간: 분기 계약, 3일 활성화 지연

**결과**:

* 여러 트레이더로 리스크 분산
* 어느 한 명도 손실 한도를 초과할 수 없음
* 각 트레이더의 손익을 개별 추적
* 성과가 낮은 트레이더는 분기 말에 제거

### 부채 관리 AI

**설정**: Ripe Protocol 부채 관리자 AI Agent

**권한**:

* 부채 관리: 대출 상환, 담보 추가
* 수익 관리: 상환용 자금을 위해 Aave/Morpho에서 인출
* 한도: 트랜잭션당 $50k, 일일 $200k

**결과**:

* 24시간 내내 150% 담보비율 유지
* 필요할 때 수익 포지션을 자동 인출해 상환
* 시장 변동성 동안 담보 $15k 추가
* 시장 20% 하락 시 청산 방지

### 청소년 트레이딩 교육

**설정**: 월간 용돈으로 DeFi를 배우는 16세 아들

**권한**:

* 매수·매도: 주요 토큰 사이 스왑 허용
* 수익 관리: Aave/Morpho/Euler만 예치 가능
* 자산: ETH, USDC, 상위 10개 토큰으로 제한
* 한도: 트랜잭션당 $100, 월간 상한 $500
* 쿨다운: 거래 간 30분
* 기간: 6개월 체험

**결과**:

* 실제 돈과 실제 리스크로 DeFi 학습
* 감당 가능한 교육 비용 수준에서 손실 제한
* 가족의 주요 자산에는 접근 불가
* 18세에 본인 월렛을 쓰기 전 경험 축적

## 라이프사이클 관리

### 매니저 상태

```
추가됨 → 대기 중 → 활성 → 만료
   │         │        │      │
   └─────────┴────────┴──────┴─→ 언제든 제거 가능
             │        │
             │        └─→ 연장 가능 (만료 시점 재설정)
             │
             └─→ 활성화 전 취소 가능
```

### 관리 계층

**사용자(소유자)**

* 어떤 매니저든 추가, 수정, 제거 가능
* 모든 설정과 한도를 수정 가능
* 활성 기간 연장 가능
* 최종 통제권은 항상 사용자에게 있음

**매니저**

* 스스로를 제거하는 것만 가능
* 권한 수정 불가
* 다른 매니저 추가 불가
* 권한 상승 공격 방지

## 자주 묻는 질문

**매니저가 다른 매니저를 추가할 수 있나요?**

아니요. 새 매니저를 추가할 수 있는 것은 월렛 소유자뿐입니다. 이를 통해 권한 상승 공격을 막습니다.

**매니저가 만료되면 어떻게 되나요?**

모든 권한을 자동으로 잃습니다. 사용자가 별도로 할 일은 없습니다.

**매니저를 제거하지 않고도 한도를 바꿀 수 있나요?**

네. 권한, 한도, 허용 자산/프로토콜은 언제든 수정할 수 있습니다.

**남은 기간 한도는 다음 기간으로 이월되나요?**

아니요. 각 기간은 전체 한도로 새롭게 시작합니다. 쓰지 않으면 사라집니다.

## 다른 기능과 함께 쓰기

### 매니저와 수취인

* 매니저는 자신의 한도 안에서 승인된 [수취인](/ko/undefined-1/payees)에게 전송할 수 있습니다
* 수취인 제한을 추가하면 알려진 주소로만 전송하도록 좁힐 수 있습니다
* 벤더 결제 권한이 필요한 지급 담당 역할에 적합합니다

### 매니저와 수표

* 매니저는 자신의 지출 한도 안에서 [수표](/ko/undefined-1/cheques)를 생성할 수 있습니다
* 수표 금액은 매니저의 일일/기간/생애 한도에 포함됩니다
* 수표의 시간 지연은 추가 보안 계층이 됩니다

### 매니저와 화이트리스트

* 매니저는 사용자가 화이트리스트 관리 권한을 명시적으로 부여한 경우에만 [화이트리스트](/ko/undefined-1/whitelist)와 상호작용할 수 있습니다
* 주소가 화이트리스트에 올라가면, 그 주소로의 전송은 일반적인 수취인과 수표 제어를 우회합니다
* 화이트리스트는 긴급 접근과 내부 자본 라우팅에 쓰고, 일상 운영에는 매니저, 수취인, 수표를 사용하세요


# 수취인

에이전트가 필요한 서비스 비용을 정확한 한도 안에서 반복 결제하도록 합니다

수취인(Payee)은 [프로그래머블 월렛](/ko/undefined-1/user-wallet)에서 결제를 받을 수 있도록 미리 승인된 주소입니다. 단, 그 범위는 사용자가 정한 정확한 한도 안으로 제한됩니다. 시장 데이터 피드, 모델 제공자, 컴퓨트 벤더, 외주 인력, 급여, 구독 서비스처럼 반복 결제가 필요한 대상을 미리 승인해 두세요. 결제당 한도, 기간 한도, 허용 자산, 쿨다운(cooldown)을 설정할 수 있습니다. 자금은 실제로 필요한 마지막 순간까지 DeFi에서 계속 수익을 냅니다.

트레이딩 에이전트는 고정된 USDC 한도 안에서 데이터 피드, 추론 API, GPU 제공자를 계속 가동할 수 있습니다. CFO는 준비금에는 손대지 않고 벤더에게 결제할 수 있습니다. 직원은 자신의 급여를 정확한 금액만큼 인출할 수 있습니다. 모든 결제는 사용자가 정한 규칙에 따라 검증되고, 전송되는 마지막 순간까지 한 푼도 빠짐없이 수익을 냅니다.

## 수취인(Payee)이 필요한 이유

### 에이전트 결제 문제

AI 에이전트가 실제로 동작하려면 서비스 비용을 결제해야 합니다. 시장 정보를 위한 데이터 피드, 의사결정을 위한 추론 API, 실행을 위한 컴퓨트 제공자가 필요합니다. 하지만 에이전트에게 무제한 지출 권한을 주는 것은 위험합니다. 버그나 익스플로잇 하나면 월렛이 비워질 수 있습니다.

수취인은 특정 수취인을 미리 승인하고 강제 한도를 설정함으로써 이 문제를 해결합니다. 트레이딩 에이전트는 고정된 USDC 예산 안에서 데이터 피드와 GPU 제공자를 계속 사용하게 할 수 있지만, 초과 지출도, 새 수취인 추가도, 예산 밖 자금 접근도 불가능합니다. 에이전트는 ([매니저](/ko/undefined-1/managers)로서) 결제를 실행할 수만 있습니다. 누가 돈을 받을지는 오직 소유자가 결정합니다.

### 반복적인 암호화폐 결제의 문제

에이전트든 사람이든, 오늘날 정기적인 암호화폐 결제를 하려면 좋지 않은 선택지 중 하나를 고르게 됩니다.

* **수동 전송**: 매 결제 주기마다 주소를 다시 입력하고, 오타 위험을 감수하고, 시간을 낭비해야 합니다
* **완전한 접근 허용**: 프라이빗 키를 공유하거나 무제한 지출 권한을 줘야 합니다
* **전통 은행 사용**: 송금 수수료를 내고, DeFi 수익을 포기하고, 처리 시간을 기다려야 합니다

이 어느 것도 자동화가 필요한 에이전트, 기업, 개인에게 적합하지 않습니다.

### 수취인 해법

수취인 목록은 세밀하게 통제되는 검증된 수취인 체계를 만듭니다.

```
기존 방식: 벤더에게 신용카드 제공 → 원하는 금액을 원하는 때에 청구
Underscore: 벤더를 수취인으로 추가 → 월 $5,000 한도 → USDC만 → 분기마다 자동 만료
```

자금은 결제 순간까지 Aave, Morpho, Euler 같은 DeFi 프로토콜에서 계속 수익을 냅니다. 시스템은 필요한 순간에 필요한 만큼만 자동 인출합니다. 여기에 더해 모든 DeFi 활동에 대해 [보상](/ko/undefined-2/rewards)도 획득할 수 있습니다.

## 사전 승인된 수취인, 온체인에서 강제

### 소유자가 통제하는 수취인 목록

**소유자 직접 통제**: [소유자 지갑](/ko/undefined-1/user-wallet)인 사용자만 수취인 항목을 직접 추가, 확정, 확장할 수 있습니다. 매니저는 새 수취인을 제안할 수는 있지만, 그 제안은 설정된 지연이 지난 뒤 소유자가 승인하기 전까지 보류 상태로 남습니다. 수취인은 스스로를 제거할 수는 있지만, 소유자 외에는 누구도 활성화하거나 한도를 넓힐 수 없습니다. 이는 정책이 아니라 스마트 컨트랙트로 강제됩니다.

### 변경에 강한 수취인 기록

**온체인 수취인 기록**: 수취인 항목이 설정되면 수취인 주소와 한도는 온체인에 저장됩니다. 매니저가 몰래 "GPU Provider"를 다른 주소로 바꾸거나 소유자 승인 없이 한도를 넓히는 일은 불가능합니다.

### 매니저는 결제만 하고, 목록은 넓히지 못합니다

**권한 분리**: 매니저는 활성화된 수취인에 대해 설정된 한도 안에서만 결제를 실행할 수 있습니다. 하지만 새 수취인을 단독으로 활성화하거나, 수취인 한도를 높이거나, 승인되지 않은 목적지로 자금을 보낼 수는 없습니다. 수취인 목록은 소유자가 통제하고, 에이전트와 운영자는 승인된 흐름만 처리합니다.

이것이 수취인 해법의 핵심입니다. 반복 결제 수취인은 먼저 승인되고, 그 다음에 결제가 그 한도 안에서만 실행됩니다.

## 수취인 제어 및 설정

각 수취인마다 포괄적인 제어를 설정해, 결제가 의도한 방식대로만 일어나게 만들 수 있습니다. 이런 제어는 과지출, 타이밍 오류, 무단 변경을 막아 줍니다.

### 재무 한도

#### 이중 보호 시스템

모든 수취인은 토큰 수량 기준과 USD 가치 기준 한도를 모두 지원합니다.

* **트랜잭션 한도**: 단일 결제당 최대 금액 (예: 1,000 USDC 또는 $1,000)
* **기간 한도**: 일정 기간 동안의 최대 금액 (예: 5,000 USDC 또는 월 $5,000)
* **생애 한도**: 전체 누적 최대치 (예: 50,000 USDC 또는 총 $50,000)

가장 엄격한 한도가 항상 적용되므로 가격 변동성으로부터도 보호됩니다.

#### 기간 설정

* **사용자 정의 기간**: 블록 기준으로 원하는 기간 설정 가능 (예: 43,200 블록 ≈ Base에서 1일)
* **자동 초기화**: 한도는 매 기간마다 새로 갱신됩니다 (남은 금액은 이월되지 않음)
* **자주 쓰는 설정**: 일간, 주간, 격주, 월간, 분기

### 결제 제어

#### 트랜잭션 제한

* **최대 트랜잭션 수**: 기간별 결제 횟수 제한 (예: 월급이라면 월 1회)
* **쿨다운 기간**: 결제 사이 최소 대기 시간 (실수로 중복 지급되는 상황 방지)
* **만료일**: 정해진 시점이 지나면 수취인이 자동으로 비활성화됩니다 (예: 외주 계약 종료일)

#### 자산 제한

각 수취인이 어떤 토큰을 받을 수 있는지 정확히 제어할 수 있습니다.

* **단일 자산**: 오직 한 토큰만 허용 (예: 급여는 USDC만)
* **선호 자산**: 기본 자산을 두되 다른 자산도 일부 허용
* **모든 자산**: 모든 토큰 수령 가능 (트레이딩 데스크에 유용)

### 보안 기능

#### 글로벌 설정 (월렛 전체)

* **풀 결제(Pull Payment) 마스터 스위치**: 모든 풀 결제 허용/비허용
* **자기 결제 토글**: 자기 자신에게 결제할 수 있게 할지 여부
* **기본 한도**: 새 수취인이 상속받는 기본 설정

#### 개별 오버라이드

* **사용자 정의 한도**: 특정 관계에 대해 글로벌 설정을 덮어쓰기
* **풀 결제 권한**: 글로벌에서 꺼져 있어도 수취인별로 허용 가능
* **자산 화이트리스트**: 글로벌 설정보다 더 좁은 토큰 제한

### 시스템 한도

* **최대 수취인 40개**: 월렛당 수용량
* **최대 자산 40개**: 수취인별 제한 목록
* **안전 차단**: 가격 오라클을 사용할 수 없으면 결제 차단
* **가능하면 켜 두세요**: 가격 피드에 장애가 발생하면 월렛이 비워질 수 있기 때문입니다
* **꺼도 되는 경우**: 1:1 페그를 신뢰하는 순수 스테이블코인 운영

가격 오라클은 실제 자산 가격을 블록체인에 제공하는 필수 서비스입니다. 이 가격 데이터가 없을 때 결제를 막음으로써, 오라클 장애 상황에서 자금이 빠져나갈 수 있는 잠재적 익스플로잇을 방지합니다.

### 풀 결제(Pull Payment) 안전장치

**강제 조건**: 풀 결제는 한도를 설정하지 않고 활성화할 수 없습니다. 시스템은 무제한 접근을 막기 위해 최소 하나의 상한(트랜잭션 또는 기간 한도)을 반드시 요구합니다.

## 권한 시스템

### 누가 수취인을 추가할 수 있나요

* **소유자**: 어떤 수취인이든 추가, 확정, 수정, 제거할 수 있는 완전한 권한
* **매니저**: 새 수취인 제안 가능 (지연 후 소유자 승인 필요)
* **기타 주체**: 수취인이나 그 한도를 변경할 권한 없음

### 누가 결제를 실행할 수 있나요

* **소유자**: 한도 안에서 어떤 활성 수취인에게든 결제 가능
* **매니저**: 매니저 한도와 수취인 한도를 모두 만족하는 경우에만 활성 수취인에게 결제 가능
* **수취인**: 명시적으로 허용된 경우 풀 결제 가능

### 누가 제거할 수 있나요

* **소유자**: 어떤 수취인이든 즉시 제거 가능
* **수취인**: 스스로를 제거 가능 (정리된 종료 방식)
* **매니저**: 수취인을 직접 제거할 수 없음

## 라이프사이클 관리

### 활성화 흐름

```
추가됨 → 대기 중 → 활성 → 만료/제거
          (지연)    (사용 중)
```

### 일반적인 활성화/만료 조합

| 사용 사례       | 활성화 지연 | 자동 만료 | 이 조합을 쓰는 이유            |
| ----------- | ------ | ----- | ---------------------- |
| **새 벤더**    | 7일     | 90일   | 새로운 관계에 높은 보안, 분기별 재검토 |
| **정규 직원**   | 3일     | 365일  | 중간 수준 보안, 연간 계약 주기     |
| **신뢰하는 가족** | 1일     | 없음    | 긴급 상황에서 빠른 접근, 지속 관계   |
| **구독 서비스**  | 2시간    | 30일   | 빠른 설정, 월별 청구 주기에 맞춤    |

### 관리 계층

**소유자(사용자)**

* 직접 추가/수정/제거
* 매니저 제안 확정
* 최종 통제권 항상 보유

[**매니저**](/ko/undefined-1/managers) — 승인된 운영자

* 한도 안에서 활성 수취인에게 결제 가능
* 새 수취인을 제안할 수 있음 (사용자 승인 필요)
* 직접 활성화, 제거, 한도 확장은 불가능
* 통제를 유지하면서 반복 결제를 위임하기에 적합

**수취인**

* 스스로 제거 가능
* 깔끔한 종료를 지원

> **📋 매니저의 제안은 사용자 승인이 필요합니다**\
> 매니저가 새 수취인을 제안하면 보류 중 요청이 생성됩니다. 사용자가 설정한 보안 지연이 지난 뒤, 사용자가 직접 확정해야 수취인이 활성화됩니다. 이 2단계 프로세스는 승인되지 않은 수취인 추가를 막아 줍니다.

## 풀 결제(Pull Payment): 수취인이 시작하는 선택형 인출

수취인이 사용자의 월렛에서 직접 자금을 인출하도록 허용할 수 있습니다. 단, 언제나 사용자가 미리 정한 한도 안에서만 가능합니다.

### 작동 방식

1. 수취인이 사용자 월렛에서 인출을 시작합니다
2. 스마트 컨트랙트가 설정된 모든 한도를 검증합니다
3. 필요하다면 수익 포지션에서 자금을 자동으로 조달합니다
4. 한도 안이라면 결제가 즉시 실행됩니다

### 이중 활성화가 필요합니다

```
전역 설정: canPull = true  AND  수취인 설정: canPull = true
                ↓
         풀 결제 활성화
```

### 실제 숫자로 보면

기존 구독 방식:

* 매달 $500가 유휴 상태로 대기 = 수익 $0

풀 결제를 쓰면:

* 월 $500가 연 5% 수익 = 연 $25 추가
* 연간 $6,000 구독 비용 = 연 $300 보너스

**안전성**: 풀 결제가 허용된 수취인에는 반드시 한도가 있어야 합니다. 무제한 접근은 허용되지 않습니다.

## 실제 설정 예시

### 에이전트 데이터 피드

```
수취인: Market Data Provider
기간: 30일
한도: 월 $200, 1회 결제
풀 결제 활성화: 예
쿨다운: 25일
자산: USDC만
결과: 에이전트의 데이터 피드가 자동으로 계속 유지됨
```

### 에이전트 컴퓨트 제공자

```
수취인: GPU Compute Vendor
기간: 7일
한도: 주 $500, 결제당 $50
풀 결제 활성화: 아니오 (에이전트가 직접 결제 실행)
자산: USDC만
결과: 주간 예산이 초기화되며 컴퓨트 비용에 상한 적용
```

### 에이전트 추론 API

```
수취인: Inference API Provider
기간: 30일
한도: 월 $1,000, 최대 50회
풀 결제 활성화: 예
쿨다운: 6시간
자산: USDC만
결과: 에이전트가 추론 엔드포인트를 호출하면, 제공자가 사용량 기준으로 대금을 인출
```

### 직원 급여 설정

```
수취인: John Smith - Developer
한도: 격주 $5,000, USDC만
일정: 매달 1일과 15일
결과: 수익을 내는 자금에서 급여 자동 지급
```

### 벤더 관리

```
벤더: SupplyCo
기간: 7일
한도: 트랜잭션당 $2k, 주간 $8k, 생애 $100k
쿨다운: 1시간
자산: 모든 스테이블코인
결과: 경계 안에서 유연한 결제 가능
```

### 가족 지원

```
수취인: 대학생 딸
기간: 30일
한도: 월 $2k, 2회 결제로 분할
자산: USDC만
활성화: 1일 지연
결과: 자동 용돈 지급, 언제든 조정 가능
```

### SaaS 구독

```
서비스: Analytics Platform
풀 결제 활성화: 예
기간: 30일
한도: 월 $149, 1회 결제
쿨다운: 25일
자산: USDC만
결과: 결제를 놓치지 않고, 대기 자금은 계속 수익 창출
```

## 자주 묻는 질문

**만료되면 어떻게 되나요?**\
수취인은 자동으로 비활성화됩니다. 갱신 전까지 결제는 차단됩니다.

**실수로 너무 많이 보내면 어떻게 되나요?**\
그럴 수 없습니다. 블록체인 스마트 컨트랙트가 강제하는 한도 때문에, 설정한 것보다 많이 보내는 것은 불가능합니다.

**직원마다 별도 수취인(Payee)이 필요한가요?**\
네. 각 수취인마다 개별 한도와 추적 정보가 따로 관리됩니다.

**설정 후 한도를 바꿀 수 있나요?**\
네. 변경 사항은 즉시 적용됩니다.

## 완벽한 조합: 매니저 + 수취인

**수취인**은 어떤 반복 결제 대상이 자금을 받을 수 있는지 정의합니다.\
\*\*[매니저](/ko/undefined-1/managers)\*\*는 자신의 권한과 예산 안에서 승인된 결제 흐름을 실행합니다.

둘을 함께 쓰면 강력한 권한 분리 모델이 만들어집니다.

* 사용자는 결제 주소를 한 번 검증해 수취인으로 등록합니다
* 매니저는 일상 운영을 처리합니다 (그 수취인에게만 결제)
* 최종 통제권은 사용자에게 남습니다 (직접 수취인을 활성화하거나 확장할 수 있는 것은 소유자뿐)

이 권한 분리 덕분에 신뢰를 넘기지 않고도 일을 위임할 수 있습니다. CFO는 가짜 수취인을 추가하지 못한 채 승인된 벤더에게만 결제할 수 있습니다. AI는 알 수 없는 주소로 자금을 보내지 못한 채 승인된 서비스만 계속 가동할 수 있습니다.

AI 에이전트에게 이 분리는 특히 중요합니다. 에이전트(매니저)는 사전 승인된 서비스 제공자(수취인)에게 결제를 실행할 수 있지만, 새 수취인을 추가하거나 지출 한도를 수정할 수는 없습니다. 어떤 서비스를 에이전트가 결제할 수 있는지, 얼마나 쓸 수 있는지는 월렛 소유자가 정의하며, 이는 정책이 아니라 온체인에서 강제됩니다.

**자세히 보기**: [매니저](/ko/undefined-1/managers)가 결제 워크플로를 어떻게 자동화하는지 확인하세요.

## 관련 기능

* [**디지털 수표**](/ko/undefined-1/cheques): 시간 지연과 취소 기능이 있는 일회성 결제
* [**매니저**](/ko/undefined-1/managers): AI 또는 팀에 결제 작업을 위임하는 방법
* [**화이트리스트**](/ko/undefined-1/whitelist): 가장 신뢰하는 주소로의 즉시 무제한 전송 설정
* [**프로그래머블 월렛**](/ko/undefined-1/user-wallet): 프로그래머블 월렛과 전체 기능 살펴보기


# 디지털 수표

무조건적인 신뢰 없이 처리하는 일회성 지출 — 검토 지연과 취소가 가능한 결제

디지털 수표는 현금화되기 전까지 완전한 통제권을 유지할 수 있는 타임락 결제 약속입니다. 에이전트가 새 거래 상대에게 결제해야 할 때, 디지털 수표는 단순 전송을 통제 가능한 결제 약속으로 바꿉니다. 소액 지출은 즉시 처리됩니다. 큰 금액은 검토 지연 뒤에 놓이고, 실제 현금화 전까지 취소할 수 있습니다. 자금은 청구되는 마지막 순간까지 계속 수익을 냅니다.

에이전트는 $3짜리 데이터셋을 즉시 구매할 수 있습니다. $5,000 규모의 컴퓨트 작업은 취소 가능한 검토 창 뒤에서 대기합니다. 외주 결제에는 기본 검토 시간이 붙습니다. 사전 승인도 필요 없습니다. 어떤 주소로든 보낼 수 있습니다. 현금화 전까지 언제든 취소할 수 있습니다. 양측 모두에게 온체인에서 완전한 투명성이 제공됩니다.

## 디지털 수표가 필요한 이유

### 즉시 실행되는 암호화폐 결제의 문제

기존 암호화폐 전송은 보내는 순간 되돌릴 수 없습니다. 유예 기간도 없고, 번복도 없습니다. 이는 다음과 같은 정상적인 거래에서도 불필요한 리스크를 만듭니다.

* 대금을 지급하기 전에 작업 결과를 검증해야 하는 경우
* 큰 금액에는 추가 보안 절차가 필요한 경우
* 결제 시점을 비즈니스 프로세스와 맞춰야 하는 경우
* 주소나 금액 실수를 수정할 수 있어야 하는 경우

### 왜 에이전트에게 수표가 필요한가

AI 에이전트에게 디지털 수표는 통제된 일회성 지출 수단입니다. [수취인](/ko/undefined-1/payees)이 익숙한 수취인에 대한 반복 결제를 처리한다면, 수표는 새 거래 상대와의 단발성 구매를 처리합니다. 데이터셋을 사거나, 일회성 분석 비용을 내거나, 임시 컴퓨트 자원을 확보할 때 적합합니다. 작은 구매는 즉시 처리되고, 큰 금액은 사용자가 이상 여부를 검토할 수 있도록 검토 창을 갖습니다.

### 디지털 수표 해법

디지털 수표는 결제 승인과 실제 실행을 분리합니다.

* **지금 작성하고 나중에 결제**: 사용자가 원하는 조건에 따라 실행되는 결제 약속 생성
* **현금화 전까지 취소 가능**: 자금이 실제 전송되는 순간까지 통제 유지
* **자동 보안 지연**: 큰 금액은 기본 검토 기간이 붙음
* **수익 유지**: 실제 결제 전까지 자금이 월렛에서 수익을 내고, [프로토콜 보상](/ko/undefined-2/rewards)도 받을 수 있음
* **일회성에 최적화**: 반복 일정 관리가 필요 없어 단발성 결제에 적합

## 4단계 라이프사이클

```
생성 → 타임락 상태 → 활성 상태 → 종료
  │         │             │          │
  └─────────┴─────────────┴──────────┴─→ 결제 전까지 언제든 취소 가능
```

### 작성 (생성)

종이 수표를 쓰듯, 수취인과 금액을 지정합니다. 이 시점의 USD 가치를 기록하는데, 종이 수표에 오늘 날짜를 적는 것과 비슷합니다. 아직 돈은 움직이지 않습니다. 지금은 단지 결제 약속만 만든 상태입니다.

### 날짜 지정 (타임락)

후일 지급 수표를 떠올리면 이해하기 쉽습니다. 보안 지연도 같은 원리입니다.

* 큰 금액은 보호를 위해 자동으로 "후일 지급" 상태가 됩니다
* 미래 시점 결제를 위해 사용자 정의 날짜를 설정할 수 있습니다
* 자금은 은행 계좌에 남아 있듯 월렛 안에서 계속 수익을 냅니다

### 현금화 가능 (활성)

이제 수표는 유효하며, 다음 주체가 현금화할 수 있습니다.

* 사용자가 즉시 처리하기로 결정할 때
* [권한이 있는 보조 운영자(매니저)](/ko/undefined-1/managers)가 처리할 때
* 수취인이 직접 입금할 때 (사용자가 이 기능을 켜 둔 경우)

### 지급 완료 또는 무효 (종료)

실물 수표처럼 결과는 둘 중 하나입니다.

* **지급 완료**: 자금이 수취인에게 성공적으로 전송됨
* **무효**: 현금화되지 않은 채 만료되거나 사용자가 취소함

## 스마트 보안 기능

### 자동 USD 임계값

하나의 지연 기준만 설정하면 됩니다 (예: $1,000).

* 기준 이하: 즉시 수표 생성 가능
* 기준 초과: 자동 지연 적용

> **참고**: [화이트리스트](/ko/undefined-1/whitelist)에 등록된 주소로는 수표를 생성할 수 없습니다. 어떤 주소를 화이트리스트에 올릴 만큼 신뢰한다면, [화이트리스트 기능](/ko/undefined-1/whitelist)을 써서 즉시 무제한 전송을 하세요. 수표는 결제 제어가 필요한 주소를 위한 도구입니다.

예시:

* $500 결제 → 지연 없음
* $5,000 결제 → 보안 지연 적용

### 시간 제어

* **고액 지연**: 고액 수표가 대기하는 시간 (예: 3\~7일)
* **기본 만료**: 수표가 활성 상태로 유지되는 시간 (예: 30일)
* **사용자 정의 시점**: 필요하면 수표별로 덮어쓰기 가능

시간은 블록 수로 측정됩니다. Base L2에서는 블록당 약 2초, 하루 약 43,200 블록입니다.

## 재무 제어

원하는 방식대로 디지털 수표가 정확히 작동하도록 다양한 한도와 제어를 설정할 수 있습니다. 이런 제어는 리스크를 관리하고, 실수를 막고, 결제 작업을 계속 감독할 수 있게 해 줍니다. 개인 재무를 관리하든, 기업에서 벤더 결제를 처리하든, 필요와 허용 범위에 맞춰 조정할 수 있습니다.

### 생성 한도

* **최대 활성 수표 수**: 아직 결제되지 않은 수표의 총 개수 (예: 20개)
* **최대 수표 금액**: 단일 수표의 최대 금액 (예: $50,000)
* **기간 한도**: 월간 생성 총량 제한 (예: $100,000)

### 결제 한도

* **기간별 결제 상한**: 일정 기간 동안 현금화 가능한 최대 금액 (예: 주 $50,000)
* **결제 쿨다운**: 결제 사이 최소 간격 (예: 10분)

### 자산 제한

수표를 특정 토큰으로 제한할 수 있습니다.

* 보수적인 운영을 위한 스테이블코인 전용
* 유연한 비즈니스를 위한 모든 토큰 허용
* 회계를 단순화하기 위한 단일 자산 사용

## 권한 시스템

### 누가 생성할 수 있나요

**소유자**: 언제나 어떤 수표든 생성 가능\
**매니저**: 글로벌 설정에서 활성화되어 있고, 개별적으로도 허용된 경우에만 가능

### 결제 방식

**푸시 결제**: 사용자 또는 매니저가 직접 실행하는 방식\
**풀 결제**: 수취인이 준비되면 청구하는 방식 (명시적으로 활성화해야 함)

### 누가 취소할 수 있나요

**소유자**: 어떤 수표든 결제 전까지 언제든 취소 가능\
**보안 담당자**: 비상시 취소 권한만 보유

## 실제 설정 예시

### 에이전트 데이터셋 구매

```
금액: $3 USDC
지급 가능 시점: 즉시 (임계값 이하)
만료: 24시간
풀 결제: 활성화
결과: 에이전트가 데이터셋을 즉시 구매, 별도 검토 불필요
```

### 에이전트 일회성 서비스 결제

```
금액: $500 USDC
지급 가능 시점: 즉시 (기준 $1,000 이하)
만료: 7일
풀 결제: 활성화
결과: 에이전트가 일회성 컴퓨트 작업 비용을 결제하고, 제공자는 원할 때 청구
```

### 에이전트 대규모 구매 (검토 포함)

```
금액: $5,000 USDC
지급 가능 시점: 3일 (임계값 초과로 자동 적용)
만료: 30일
검토: 소유자는 3일 지연 동안 이상하면 취소 가능
결과: 큰 규모의 에이전트 지출에 사람의 검토 창 제공
```

### 개인 간 결제

```
금액: $30 USDC
지급 가능 시점: 즉시 (임계값 이하)
만료: 7일
풀 결제: 활성화
결과: 친구가 편한 때에 점심값 수령
```

### 프리랜서 송장

```
금액: $3,000 USDC
지급 가능 시점: 3일 (기준 $1,000 초과로 자동 적용)
만료: 30일
풀 결제: 활성화
결과: 클라이언트는 지급 의사를 증명하고, 프리랜서는 시점을 조절 가능
```

### 월세

```
금액: $2,500 USDC
생성일: 매달 25일
지급 가능 시점: 다음 달 1일
풀 결제: 활성화
결과: 집주인은 제때 지급받고, 사용자는 그전까지 통제 유지
```

### 고액 계약

```
금액: $50,000 USDC
지급 가능 시점: 7일 (고액 지연)
만료: 45일
검토 장점: 결과물을 검증할 시간 확보
지연 중 발생 수익: 약 $48*
```

\*수익은 당시 시장 금리에 따라 달라집니다

## 수취인 경험

디지털 수표는 발신자에게 안전하면서도 수취인에게는 간단해야 하도록 설계됐습니다. 수취인은 블록체인에서 수표의 존재와 조건을 확인한 뒤에 상품이나 서비스를 제공할 수 있으므로 완전한 투명성을 얻습니다. 보안 지연이 끝나면, 유효 기간 안에서 원하는 시점에 결제를 청구할 수 있습니다.

이 구조는 신뢰를 쌓습니다. 수취인은 발신자의 지급 의사를 볼 수 있고, 발신자는 문제가 생길 경우 취소할 수 있습니다. 블록체인은 양측 모두에게 결제 상태를 항상 명확히 보여 주므로, 기존 결제 방식에서 흔한 불확실성이 사라집니다.

## 고급 기능

### [매니저](/ko/undefined-1/managers)가 생성한 수표

AI나 팀원이 사용자의 규칙 안에서 수표를 만들도록 할 수 있습니다. [수표 권한이 있는 매니저 설정 방법](/ko/undefined-1/managers)을 참고하세요.

1. [매니저](/ko/undefined-1/managers)가 승인된 송장을 바탕으로 수표 생성
2. 타임락 자동 적용
3. 사용자가 지연 기간 동안 검토
4. 취소하거나 그대로 진행

### 스마트 자금 조달

자동 결제 시스템과 마찬가지로, 수표도 필요할 때 수익 포지션에서 자금을 지능적으로 조달합니다.

* 먼저 유동 잔액 확인
* 부족하면 Aave/Morpho 등에서 자동 인출
* 하나의 트랜잭션으로 결제 완료

## 자주 묻는 질문

**잘못된 금액을 보냈다면 어떻게 되나요?**\
현금화되기 전에 수표를 취소하고 새로 만들면 됩니다.

**수취인이 대기 중인 수표를 볼 수 있나요?**\
네. 생성 시점부터 온체인에서 완전히 공개됩니다.

**수표 내용을 수정할 수 있나요?**\
아니요. 대신 취소하고 새 조건으로 다시 만들 수 있습니다.

**화이트리스트 주소로 수표를 쓸 수 있나요?**\
아니요. 그런 경우에는 [화이트리스트](/ko/undefined-1/whitelist)를 사용하세요. 수표는 결제 제어가 필요한 비화이트리스트 수취인을 위한 도구입니다.

**수표가 만료되면 어떻게 되나요?**\
은행에서 무효 처리된 수표처럼, 만료된 수표는 자동으로 효력을 잃습니다. 자금은 월렛을 떠난 적이 없기 때문에 즉시 다른 용도로 사용할 수 있습니다. 사용자에게 별도 작업은 필요 없습니다.

**수표 금액이나 개수에 제한이 있나요?**\
네. 보안을 위해 단일 수표 최대 금액과 전체 활성 수표 수를 설정할 수 있습니다. 이런 안전장치는 과도한 약속을 방지하면서도 일반적인 사용에는 충분한 유연성을 제공합니다.

**내** [**매니저**](/ko/undefined-1/managers)**가 수표를 대신 처리할 수 있나요?**\
네. 매우 유용한 기능입니다. [매니저](/ko/undefined-1/managers)에게 사용자가 정한 한도 안에서 수표 생성 및 취소 권한을 줄 수 있습니다. CFO가 벤더 결제를 처리하는 기업이나, 재무 자문가가 큰 거래를 함께 관리해 주기를 원하는 개인에게 적합합니다. 핵심은 매니저가 언제나 사전 설정된 경계 안에서만 작동한다는 점입니다. 지출 한도를 넘을 수도 없고, 보안 설정을 바꿀 수도 없습니다. 이런 안전한 위임 권한을 설정하는 방법은 [매니저로 월렛 관리하기](/ko/undefined-1/managers) 가이드를 참고하세요.

## 관련 기능

* [**수취인**](/ko/undefined-1/payees): 정기 지출을 위한 자동 반복 결제 설정
* [**매니저**](/ko/undefined-1/managers): AI 또는 팀에 결제 작업을 위임하는 방법
* [**화이트리스트**](/ko/undefined-1/whitelist): 가장 신뢰하는 주소로의 즉시 무제한 전송 설정
* [**프로그래머블 월렛**](/ko/undefined-1/user-wallet): 프로그래머블 월렛과 전체 기능 살펴보기


# 화이트리스트

타임락 보안과 함께, 가장 신뢰하는 주소로 즉시 무제한 전송

화이트리스트는 특정 주소를 프로그래머블 월렛에서 가장 신뢰하는 주소로 등록해, 제한 없이 자금을 받을 수 있게 해줍니다. 지출 한도도, 지연도, 제약도 없습니다. 하드웨어 월렛, 콜드 스토리지, 다른 프로그래머블 월렛, 또는 긴급 연락용 주소에 적합합니다. 시장이 급변할 때 수백만 달러를 즉시 이동할 수 있고, 계정이 손상됐을 때는 몇 초 안에 자금을 대피시킬 수도 있습니다. 멀티월렛 전략도 기회가 생기는 즉시 실행할 수 있습니다.

주소 추가는 타임락 보안 지연(설정 가능, 일반적으로 3\~7일)을 거치므로 무단 추가를 막을 수 있습니다. 주소가 손상되면 즉시 제거할 수 있습니다. 화이트리스트 전송은 언제나 제한 없이 즉시 실행됩니다. 이것이 사용자가 줄 수 있는 최고 수준의 신뢰입니다.

## 화이트리스트가 필요한 이유

### 세 가지 수취인 제한 구조의 문제

[월렛](/ko/undefined-1/user-wallet)은 모든 수취인이 반드시 다음 셋 중 하나에 속해야만 결제를 받을 수 있도록 합니다. [수취인](/ko/undefined-1/payees)(한도 있음), [수표](/ko/undefined-1/cheques)(지연 있음), 또는 화이트리스트입니다. 이 구조는 안전하지만 번거로움도 만듭니다.

* **수취인**: 반복 결제에는 좋지만, 큰 금액 전송에는 한도가 걸립니다
* **수표**: 일회성 결제에는 좋지만, 지연 때문에 시간 민감한 기회는 놓칠 수 있습니다
* **빠진 선택지**: 그렇다면 내 다른 월렛처럼 즉시 무제한 접근이 필요한 주소는 어떻게 해야 할까요?

AI 에이전트가 차익거래를 포착하거나 DAO가 재무를 통합해야 할 때, [수취인](/ko/undefined-1/payees) 한도와 [수표](/ko/undefined-1/cheques) 지연은 수익 기회를 날리게 만드는 제약이 됩니다.

### 화이트리스트 해법

화이트리스트는 절대적 신뢰를 전제로 한 특별한 수취인 범주를 추가해 결제 삼각 구조를 완성합니다.

* **내 다른** [**프로그래머블 월렛**](/ko/undefined-1/user-wallet): 내 계정 사이에 수백만 달러를 즉시 이동
* **하드웨어 월렛**: 위협이 발생했을 때 마찰 없이 자금을 안전하게 이동
* **기업 재무 월렛**: 비즈니스 운영을 위해 즉시 자금 통합 가능
* **타임락 보안**: 추가에는 대기 기간이 있고, 제거는 즉시 적용
* **매니저와도 호환**: 자금을 넘기지 않고도 화이트리스트 관리를 위임할 수 있음

## 화이트리스트 작동 방식

### 결제 계층

[월렛](/ko/undefined-1/user-wallet)은 결제 수취인을 세 가지 유형으로 인식합니다.

```
[수취인](payees.md) → 설정된 한도 안에서 반복 결제
[수표](cheques.md) → 지연과 취소가 가능한 일회성 결제
화이트리스트 → 즉시 무제한 전송
```

이 세 범주 중 하나에 들어 있는 주소만 월렛으로부터 결제를 받을 수 있습니다.

### 트랜잭션 흐름

```
사용자가 전송 시작
        ↓
수취인이 화이트리스트에 있는가?
        ↓
    ┌───┴───┐
    │       │
    예    아니오
    │       │
    ↓       ↓
즉시 전송   승인된 수취인 또는 수표 대상인가?
진행             ↓
            ┌───┴───┐
            │       │
           예    아니오
            │       │
            ↓       ↓
        한도 적용 후   트랜잭션
        진행           차단
```

## 보안 기능

### 타임락 추가

화이트리스트 주소를 추가할 때는 사용자가 정한 보안 지연을 거칩니다.

```
제안 → 타임락 → 확정 → 활성
1일차   사용자 선택   준비 완료   제거 전까지
```

**이것이 월렛 손상에 대한 최후의 방어선입니다.**

모든 프로그래머블 월렛에는 최종 통제권을 가진 외부 소유자 지갑이 있습니다. 보통 EOA 또는 하드웨어 월렛입니다. 만약 공격자가 이 소유자 지갑을 손상시키더라도, 타임락은 중요한 방어 시간을 제공합니다.

공격자가 소유자 지갑을 완전히 통제하더라도, 프로그래머블 월렛의 자금을 즉시 빼갈 수는 없습니다. 이유는 다음과 같습니다.

1. **공격자가 자기 주소를 화이트리스트에 추가하려고 시도** → 타임락 기간(예: 7일)에 들어감
2. **사용자가 대기 중인 추가를 확인** → 대응 시간이 분 단위가 아니라 며칠 단위로 확보됨
3. **사용자가 즉시 악성 추가를 취소** → 공격 계획이 무산됨
4. **이미 화이트리스트에 올려 둔 콜드 스토리지로 모든 자금을 이동** → 자금 안전 확보

공격자는 자신의 의도를 먼저 드러낼 수밖에 없고, 그동안 사용자는 여전히 완전한 통제권을 유지합니다. 공격자는 즉시 자기 주소를 추가할 수도 없고, 타임락을 앞당길 수도 없고, 이미 화이트리스트에 있는 안전한 주소로 자금을 옮기는 사용자를 막을 수도 없습니다.

이 시간 지연은 성공한 공격을 실패한 시도로 바꾸며, 자산을 보호할 수 있는 결정적인 대응 창을 제공합니다.

### 설정 가능한 보안 지연

지연 기간은 월렛의 `timeLock` 설정으로 제어되며, 블록 수 기준으로 측정됩니다. 편의성을 중시하면 더 짧게, 보안을 중시하면 더 길게 설정할 수 있습니다.

이 지연은 화이트리스트 추가뿐 아니라, 월렛의 다른 보안상 중요한 작업에도 동일하게 적용됩니다.

### 즉시 제거

추가와 달리, 화이트리스트 주소 제거는 즉시 적용됩니다. 몇 초가 중요할 때 사용자를 보호하기 위한 설계입니다.

## 권한 시스템

### 소유자(사용자)

모든 화이트리스트 작업에 대한 완전한 권한:

* 주소 추가, 확정, 취소, 제거
* 통제에 대한 제한 없음
* 다른 권한을 모두 덮어씀
* [보상](/ko/undefined-2/rewards)을 어떤 화이트리스트 월렛으로든 전송 가능

### [매니저](/ko/undefined-1/managers)

권한이 부여된 경우 위임된 화이트리스트 권한:

* **제안**: 사용자 승인을 위한 새 주소 제안
* **확정**: 보안 지연 후 추가 완료
* **취소**: 활성화 전 대기 중 추가 중단
* **제거**: 기존 화이트리스트 주소 삭제

각 권한은 명시적으로 부여해야 하며, 매니저는 사용자가 선택한 화이트리스트 권한만 부여받습니다.

### 추가 보안 기능

* **소유자 변경 보호**: 소유자가 변경되면 모든 대기 중 추가가 자동 취소
* **수표 생성 불가**: 화이트리스트 주소는 수표를 받을 수 없음
* **주소 검증**: 빈 주소, 월렛 자신, 설정 컨트랙트는 화이트리스트에 추가 불가

## 실제 사용 사례

### 멀티월렛 전략

**보수적 운용 + 공격적 운용 분리**

* 보수적 월렛: 스테이블코인 수익 파밍, 벤더 결제
* 공격적 월렛: AI 트레이딩 에이전트, DeFi 전략
* 즉시 리밸런싱: 기회가 생기면 전략 간에 수백만 달러 이동

서로를 화이트리스트에 올려 두면, AI가 알파를 포착했을 때 자본을 즉시 배치할 수 있습니다.

**보안 위협 대응**

* 액티브 월렛: 일상 운영, 더 많은 상호작용에 노출
* 안전한 콜드 스토리지: 최대 보안 구성, 드물게 접근
* 즉시 대피: 위협이 발생하면 전체 잔고를 이동

계정 손상이 의심되거나 실제 위협에 직면했을 때는 단 몇 초가 중요합니다. 안전한 저장소를 화이트리스트에 올려 두면 즉시 자금을 대피시킬 수 있습니다.

### DAO 및 기업 재무

**멀티시그 운영**

* 운영 월렛 → 메인 금고: 일일 수익 통합
* 금고 → 운영 월렛: 기회 대응용 즉시 자금 공급
* 긴급 이동: 거버넌스 결정에 즉시 반응

**부서별 자금 관리**

* 마케팅 월렛에 긴급 캠페인 자금이 필요
* 개발 월렛에 즉시 외주 결제 필요
* 투자 월렛이 시간 민감한 기회를 포착

부서 간 주소를 화이트리스트에 올려 두면 보안을 훼손하지 않으면서 운영 효율을 높일 수 있습니다.

### AI 에이전트 운영

**자동 전략 실행**

* AI가 프로토콜 간 차익거래 기회를 포착
* 수익 월렛에서 즉시 자본이 필요
* 기회 창: 종종 60초 이내

화이트리스트가 없으면 수표 지연이나 수취인 한도 때문에 거래 기회를 사실상 놓치게 됩니다.\
화이트리스트가 있으면 AI는 시장 속도로 실행합니다.

## 자주 묻는 질문

**타임락을 앞당길 수 있나요?**\
아니요. 보안을 위해 지연은 절대적입니다. 필요한 추가는 미리 계획하세요.

**화이트리스트 주소 접근을 잃어버리면 어떻게 되나요?**\
즉시 제거하세요. 손상된 화이트리스트 주소는 가장 큰 리스크입니다.

**제거된 주소를 다시 추가할 수 있나요?**\
네. 다만 전체 절차를 처음부터 다시 거쳐야 합니다.

**승인되지 않은 주소로 보내려고 하면 어떻게 되나요?**\
자금이 월렛을 떠나기 전에 트랜잭션이 차단됩니다.

**화이트리스트는 일일 전송 한도와 어떻게 상호작용하나요?**\
화이트리스트 주소는 일일, 주간, 생애 한도를 포함한 **모든 한도**를 우회합니다. 그래서 완전히 신뢰하는 주소만 화이트리스트에 올려야 합니다.

## 관련 기능

* [**수취인**](/ko/undefined-1/payees): 정기 지출을 위한 자동 반복 결제 설정
* [**디지털 수표**](/ko/undefined-1/cheques): 시간 지연과 취소 기능이 있는 일회성 결제
* [**매니저**](/ko/undefined-1/managers): AI 또는 팀에 결제 작업을 위임하는 방법
* [**프로그래머블 월렛**](/ko/undefined-1/user-wallet): 프로그래머블 월렛과 전체 기능 살펴보기


# 보상

수익 보너스와 예치 보상을 통해 RIPE 토큰을 획득하세요

Underscore를 사용하는 것만으로도 [Ripe Protocol](https://ripe.finance)의 거버넌스 토큰인 RIPE를 획득할 수 있습니다. 더 많은 수익을 만들고 더 오래 보유할수록 더 많은 RIPE를 받게 됩니다.

**획득 방법은 두 가지입니다:**

1. **수익 보너스** — 발생한 수익금에 대해 1:1로 RIPE를 추가 지급
2. **예치 보상** — 얼마나 많이, 얼마나 오래 보유했는지에 따라 RIPE 지급

친구를 초대하면, 그 친구가 낸 수익에 대해서도 RIPE를 받을 수 있습니다.

***

## 수익 보너스 (1:1 RIPE 매칭)

수익이 실현되면 추가 RIPE 토큰을 받습니다.

* **1:1 매칭** — 수익 $1를 벌 때마다, 그에 상응하는 $1 상당의 RIPE를 받습니다
* 수익을 인출할 때 자동으로 지급됩니다
* 수익 전략에만 적용됩니다 (스왑 또는 보상 청구에는 적용되지 않음)
* 분배기에 사용 가능한 RIPE 잔고가 있어야 합니다 (선착순)

**예시**: 수익금 $1,000를 인출하는 경우

* 수익 자산 기준으로 $1,000 이익은 그대로 유지합니다
* 여기에 더해 약 $1,000 상당의 RIPE 토큰도 받습니다

### 추천 보너스

친구를 Underscore에 초대하면, 그 친구가 수익을 낼 때 RIPE를 받을 수 있습니다.

* **1:1 매칭** — 추천받은 사용자가 수익 $1를 벌 때마다, 추천인도 $1 상당의 RIPE를 받습니다
* 친구 역시 본인의 1:1 보너스를 그대로 받습니다
* 같은 수익 이벤트로 양쪽 모두가 혜택을 받습니다

**예시**: 친구가 수익금 $1,000를 실현하는 경우

* 친구: $1,000 이익 유지 + 약 $1,000 상당의 RIPE 보너스
* 추천인: 추천 보상으로 약 $1,000 상당의 RIPE 보너스

***

## 예치 보상

Underscore 월렛에 자산을 보유하고 있기만 해도 RIPE를 획득할 수 있습니다.

```
포인트 = (USD 가치 × 보유한 블록 수)
내 지분 = 내 포인트 / 전체 글로벌 포인트
```

**작동 방식**:

1. [월렛](/ko/undefined-1/user-wallet)에 자산을 보유합니다
2. 시간이 지날수록 포인트가 누적됩니다
3. RIPE 보상 풀에서 자신의 비례 지분만큼 청구합니다

**예시**:

* $10,000를 2주 동안 보유
* 프로토콜 전체 포인트 = 3,024, 내 포인트 = 60.48 (2% 지분)
* 풀에 $5,000 상당의 RIPE가 있다면 → 약 $100 상당의 RIPE를 청구

***

## RIPE 토큰 상세

RIPE는 Underscore의 통합 대출 프로토콜인 [Ripe Protocol](https://ripe.finance)의 거버넌스 토큰입니다. 획득한 RIPE는 다음과 같이 활용할 수 있습니다.

* **보유**: 가격 상승 가능성에 노출
* **스테이킹**: Ripe 거버넌스에서 투표권과 추가 보상 획득
* **거래**: 지원 거래소에서 유동성 확보

### 자동 스테이킹

현재 **RIPE 보상의 80%는 자동으로 Ripe 거버넌스 볼트에 스테이킹**되며, 180일 락업 기간이 적용됩니다. 나머지 20%는 사용자의 월렛으로 바로 전송됩니다. 추가 트랜잭션 없이 스테이킹 혜택을 바로 누릴 수 있다는 뜻입니다.

***

## 수수료 구조

Underscore는 특정 활동에 대해 소액 수수료를 부과합니다.

| 활동        | 수수료   | 적용 대상                                  |
| --------- | ----- | -------------------------------------- |
| 스왑        | 0.25% | 거래 금액                                  |
| 외부 보상     | 20%   | 프로토콜 보상 청구 (MORPHO, WELL 등)            |
| 볼트 성과 수수료 | 20%   | 핵심 Vaults와 Amplified Vaults에서 발생한 수익금만 |

**수수료가 없는 항목**: 전송, 예치, 유휴 자금, 원금.

***

## 향후 계획: Ambassador 수익 공유

위에서 설명한 RIPE 수익 보너스 외에도, Ambassador는 수수료의 일정 비율을 현물 기준으로 받을 수 있습니다. 즉, 수수료가 발생한 동일 자산으로 지급됩니다. 이 기능은 프로토콜에 이미 존재하지만 현재 수익 공유 비율은 0%로 설정되어 있습니다. 향후 활성화되면, Ambassador 수익 공유분은 남은 프로토콜 수익을 [$RIPE](https://app.ripe.finance/ripe) 바이백에 배분하기 전에 먼저 차감됩니다.

***

## 자주 묻는 질문

**Q: 언제 청구할 수 있나요?**\
A: 보상이 누적되는 즉시 청구할 수 있습니다. 단, 쿨다운이 적용될 수 있습니다. 권한이 있다면 [매니저](/ko/undefined-1/managers)가 대신 청구할 수도 있습니다.

**Q: 보상이 사라질 수 있나요?**\
A: 아니요. 청구할 때까지 누적됩니다. 단, 컨트랙트 잔고 한도는 적용됩니다.

**Q: 보너스는 항상 지급되나요?**\
A: 분배기에 충분한 RIPE 잔고가 있을 때만 지급됩니다. 선착순입니다.

**Q: 예치 포인트는 어떻게 계산되나요?**\
A: 포인트 = 예치 가치 × 시간입니다. 더 많이 예치하고 더 오래 보유할수록 포인트가 많아지고, 보상 풀에서 더 큰 지분을 받습니다.

**Q: RIPE는 자동으로 스테이킹되나요?**\
A: 네. 80%는 180일 락업과 함께 Ripe 거버넌스에 자동 스테이킹되고, 20%는 월렛으로 직접 들어갑니다.

***

## 핵심 요약

수익을 벌면 RIPE를 받고, 자산을 보유해도 RIPE를 받고, 친구를 초대하면 그 친구가 수익을 낼 때 RIPE를 받습니다.

즉, 당신의 DeFi 활동이 곧바로 토큰 보상으로 이어집니다.

***

## 다음 단계

* [**Earn Vaults에 예치하기**](/ko/earn-vaults/vaults): 핵심 Vaults로 기본 수익을 얻거나 Amplified Vaults로 두 번째 수익 레이어를 더한 뒤, RIPE 보너스까지 획득하세요
* [**월렛 배포하기**](/ko/undefined-1/user-wallet): 예치 포인트 적립 시작
* [**매니저 추가하기**](/ko/undefined-1/managers): 보상 청구 자동화
* [**화이트리스트 설정하기**](/ko/undefined-1/whitelist): 신뢰하는 월렛으로 보상 전송


# 프로토콜 이코노믹스

Underscore가 수익을 창출하는 방식과 그 수익의 사용처

Underscore는 가치가 발생하는 활동에 수수료를 부과해 수익을 창출합니다. 그중 대부분은 Vault 이익에 대한 20% 성과 수수료에서 나오므로, Vault 사용자가 벌 때 프로토콜도 법니다. 프로토콜 수익의 100%는 공개 시장에서 [$RIPE](https://app.ripe.finance/ripe)를 바이백하는 데 사용됩니다.

***

## 수익원

### 볼트 성과 수수료 (핵심 수익원)

프로토콜 수익의 가장 큰 비중은 [Underscore Earn Vaults](/ko/earn-vaults/vaults)에서 나옵니다. 여기에는 핵심 Vaults와 Amplified Vaults가 포함됩니다.

* **수수료**: 발생한 수익금의 20%
* **적용 대상**: 원금이 아닌 이익분에만 적용
* **부과 시점**: 수익이 실현될 때

**예시**: 하나의 Vault가 모든 예치자를 합쳐 총 $100,000의 수익을 냈다면

* $20,000 → 프로토콜 수익
* $80,000 → 지분 토큰 가격 상승을 통해 예치자에게 분배

볼트 성과 수수료는 프로토콜 TVL과 수익 성과에 비례해 커지므로, Underscore가 성장할수록 가장 주요한 수익 원천이 됩니다.

### 스왑 수수료

Underscore 월렛을 통해 실행된 토큰 스왑에 부과됩니다.

* **수수료**: 거래 금액의 0.25%
* **적용 대상**: 모든 스왑 (스테이블코인 페어 포함)

**예시**: $10,000 스왑 → $25 수수료

### 외부 보상 청구 수수료

통합 프로토콜의 보상(MORPHO, WELL, AERO 등)을 청구할 때 부과됩니다.

* **수수료**: 청구한 보상의 20%
* **적용 대상**: 외부 프로토콜 인센티브에만 적용

**예시**: MORPHO 보상 $200 청구 → $40 수수료

***

## 무료인 항목

다음에는 수수료가 없습니다.

* 월렛 간 전송
* 예치 및 출금
* 유휴 자금
* 부채 작업 (대출/상환)
* 유동성 공급
* ETH/WETH 래핑

***

## 수익 배분: $RIPE 바이백

프로토콜 수익의 100%는 공개 시장에서 [$RIPE](https://app.ripe.finance/ripe)를 바이백하는 데 사용됩니다.

Underscore 사용량이 늘어날수록 바이백 수요도 함께 커지고, 그 가치가 더 넓은 생태계로 되돌아갑니다.

**온체인에서 검증하기**: 현재 수수료 파라미터는 [Params Explorer](https://params.underscore.finance/protocol)에서 확인하세요.

***

## 요약

| 수익원       | 수수료          | 상대적 규모            |
| --------- | ------------ | ----------------- |
| 볼트 성과 수수료 | 발생한 수익금의 20% | 가장 큼 (TVL과 함께 성장) |
| 스왑 수수료    | 금액의 0.25%    | 중간                |
| 외부 보상     | 청구 금액의 20%   | 더 작음              |

**수익의 100% → 공개 시장에서** [**$RIPE**](https://app.ripe.finance/ripe) **바이백**


