← Back to Learn

ARCHITECTURE

What's the Difference Between Non-Custodial and Custodial?

The difference is about who actually holds your money while it's earning interest. In a custodial setup, you hand funds over to a platform — a deposit, a pool, a wallet the platform controls — and trust it to manage and eventually return them. In a non-custodial setup like Hahalend, your funds never leave your own Bitfinex account; Hahalend only holds a limited-permission key that can place and cancel lending offers on your behalf, nothing more.

That distinction isn't just architecture trivia — it determines what actually happens if the company running the software has a bad day, gets hacked, or shuts down. This page walks through both models honestly, including what non-custodial does and doesn't protect you from.

What 'Custodial' Means

A custodial platform takes possession of your funds. You deposit into an account, wallet, or pool that the platform itself controls — often mixed together with other users' funds — and the platform decides how that pooled money gets used. Withdrawing means asking the platform to send funds back to you; until then, you're relying on its solvency, its internal controls, and its willingness to honor that request.

This isn't inherently a scam or automatically unsafe — plenty of custodial financial products operate responsibly. But it does mean an extra layer of trust sits between you and your money: even a well-run custodial platform is a single point of failure for anyone using it.

What 'Non-Custodial' Means — and What Hahalend Actually Is

A non-custodial setup skips that layer: your funds stay in an account only you control the whole time. Hahalend's role is limited to using a Bitfinex API key with exactly two permissions — Read (to see your balance) and Funding (to place and cancel lending offers) — checked and enforced the moment you connect a key. Any key with Withdraw or Trading access is rejected automatically before it's ever saved; there is no configuration or override that lets Hahalend hold or move your funds.

Your key itself is encrypted with AES-256-GCM before it's stored, and only decrypted in memory for the moment it's actually needed to check a balance or place an offer — never written back to disk in plain text.

The Practical Difference If Something Goes Wrong

If a custodial platform gets hacked, goes insolvent, or simply refuses withdrawals, your funds were inside its control the whole time — recovering them depends entirely on that platform's own security and integrity. If Hahalend's own servers were fully compromised, the stored keys are still encrypted ciphertext, and Bitfinex itself blocks Withdraw and Trading for any key that was never granted that permission, regardless of who's holding it. The honest edge case: an attacker who also obtained the separate encryption key could see your balances and history and place or cancel lending offers — but still couldn't move funds out of Bitfinex. That's a real, structural limit, not a promise layered on top.

What Non-Custodial Doesn't Solve

Being non-custodial toward Hahalend doesn't make Bitfinex itself risk-free — your funds still sit on a centralized exchange, and general exchange risk (downtime, a security incident, insolvency) is the same as it would be if you were lending manually with no bot at all. It also doesn't guarantee a return: funding rates move with the market, and nothing here promises a specific yield. Non-custodial removes one specific category of risk — a third party controlling your funds — it doesn't remove every risk that exists.

Frequently Asked Questions

Does Hahalend ever hold my funds?

No. Your funds stay in your own Bitfinex account at all times. Hahalend only has a key that can place and cancel lending offers there — it never takes custody of anything.

What can Hahalend's API key actually do?

Exactly two things: read your balance and history, and place or cancel lending offers. Any key with Withdraw or Trading permission is rejected automatically the moment you try to connect it.

What's the worst case if Hahalend gets hacked?

Stored keys are encrypted, and Bitfinex blocks Withdraw/Trading for any key that was never granted it, regardless of who holds it. Even in the edge case where an attacker also got the encryption key, they still couldn't move funds out of Bitfinex — only see balances or place/cancel offers.

Is non-custodial automatically safer than custodial?

It removes one category of risk — a company controlling your funds — but it doesn't remove exchange risk (Bitfinex itself), market risk, or return your funds if you mismanage your own account security.

How is this different from a typical custodial yield platform?

A custodial platform holds your funds directly and decides how to use them; you're trusting its solvency and internal controls. Hahalend never holds funds at all — it automates the same lending action you could take yourself on your own Bitfinex account.

See the Architecture for Yourself

Read the full security breakdown, or see exactly what permissions get checked when you connect a key.