# Wildcat Protocol Documentation

## Wildcat Protocol Documentation

- [The Wildcat Protocol](https://docs.wildcat.finance/readme.md): Private credit, on your terms.
- [The Elevator Pitch](https://docs.wildcat.finance/overview/introduction.md): What Wildcat is and why — undercollateralised, fixed-rate credit markets, summarised for borrowers and lenders.
- [Whitepaper](https://docs.wildcat.finance/overview/whitepaper.md): Where to find the Wildcat v2.0 whitepaper, covering the protocol's ideology, design decisions and high-level logic.
- [FAQs](https://docs.wildcat.finance/overview/faqs.md): Answers to common questions about balances, withdrawals, delinquency, market access, integrations, security and support.
- [For AI Agents & LLMs](https://docs.wildcat.finance/overview/for-ai-agents.md): How to consume the Wildcat docs as an AI agent — Markdown endpoints, llms.txt, the ?ask API, and the Wildcat skill.
- [Terminology](https://docs.wildcat.finance/using-wildcat/terminology.md): It's dangerous to go alone - learn these.
- [Onboarding](https://docs.wildcat.finance/using-wildcat/onboarding.md): How to make use of the Wildcat protocol.
- [How borrowers are onboarded](https://docs.wildcat.finance/using-wildcat/how-borrowers-are-onboarded.md)
- [Day-To-Day Usage](https://docs.wildcat.finance/using-wildcat/day-to-day-usage.md): Hands-on guides for operating Wildcat day to day, for both borrowers and lenders.
- [Borrowers](https://docs.wildcat.finance/using-wildcat/day-to-day-usage/borrowers.md): What you need to know as a Wildcat borrower.
- [Lenders](https://docs.wildcat.finance/using-wildcat/day-to-day-usage/lenders.md): How lenders deposit, read balances, transfer market tokens, request withdrawals and claim underlying assets.
- [Wildcat 4626 Wrapper](https://docs.wildcat.finance/using-wildcat/day-to-day-usage/wildcat-4626-wrapper.md): Wrap a rebasing market token into a non-rebasing ERC-4626 share for bridging, LPing or accounting.
- [Optional Collateral Contracts](https://docs.wildcat.finance/using-wildcat/day-to-day-usage/optional-collateral-contracts.md): How a borrower can pledge separate, liquidatable ERC-20 collateral to back a market.
- [Market Access Via Policies/Hooks](https://docs.wildcat.finance/using-wildcat/day-to-day-usage/market-access-via-policies-hooks.md): How V2 hooks combine role providers, credentials, sanctions checks, allowlists and known-lender status to decide market access.
- [The Sentinel](https://docs.wildcat.finance/using-wildcat/day-to-day-usage/the-sentinel.md): What's the worst that could happen?
- [Protocol Usage Fees](https://docs.wildcat.finance/using-wildcat/protocol-usage-fees.md): There's no such thing as a free lunch.
- [Delinquency](https://docs.wildcat.finance/using-wildcat/delinquency.md): What delinquency means and how it separately affects interest, liquidity, withdrawal payment and claim timing.
- [Wildcat Market CSV Exporter](https://docs.wildcat.finance/using-wildcat/wildcat-market-csv-exporter.md): Downloadable Agent Skill for ChatGPT and Claude which exports, verifies and analyses a Wildcat market's complete on-chain history.
- [Telegram Notification Bot](https://docs.wildcat.finance/using-wildcat/telegram-notification-bot.md): How to use the Wildcat Telegram Bot
- [Security/Developer Dives](https://docs.wildcat.finance/technical-overview/security-developer-dives.md): Auditor-oriented explainers of how the Wildcat V2 components work.
- [The Scale Factor](https://docs.wildcat.finance/technical-overview/security-developer-dives/the-scale-factor.md): Scaled vs market token amounts and the scaleFactor (a ray) that rebases market tokens with interest.
- [Core Behaviour](https://docs.wildcat.finance/technical-overview/security-developer-dives/core-behaviour.md): How a market operates internally: configuration, collateral obligation, interest accrual, state updates and the withdrawal batch lifecycle.
- [V1 -> V2 Changelog](https://docs.wildcat.finance/technical-overview/security-developer-dives/v1-greater-than-v2-changelog.md): If you have previously reviewed the Wildcat V1 codebase, these are the major changes made for V2.
- [Known Issues](https://docs.wildcat.finance/technical-overview/security-developer-dives/known-issues.md): Some aspects and quirks of the protocol codebase that may raise concern.
- [Hooks](https://docs.wildcat.finance/technical-overview/security-developer-dives/hooks.md): Overview of the hooks system that gates and reacts to market actions.
- [How Hooks Work](https://docs.wildcat.finance/technical-overview/security-developer-dives/hooks/how-hooks-work.md): The hookable market functions, HooksConfig flags, intermediate state, and the extraData calldata buffer.
- [Access Control Hooks](https://docs.wildcat.finance/technical-overview/security-developer-dives/hooks/access-control-hooks.md): The access-control hooks template: role providers (pull/push), credential validation, and the access-resolution flow.
- [Fixed Term Loan Hooks](https://docs.wildcat.finance/technical-overview/security-developer-dives/hooks/fixed-term-loan-hooks.md): The fixed-term variant of the access-control hooks, adding a withdrawal-blocking fixed term.
- [Wildcat 4626 Wrapper](https://docs.wildcat.finance/technical-overview/security-developer-dives/wildcat-4626-wrapper.md): Developer reference for the Wildcat4626Wrapper and its factory — functions, rounding, exchange-rate helpers and error codes.
- [Function/Event Signatures](https://docs.wildcat.finance/technical-overview/function-event-signatures.md): Index of per-contract function, event and error signatures for the V2 codebase.
- [/access](https://docs.wildcat.finance/technical-overview/function-event-signatures/access.md): Function, event and error signatures for the access-control contracts.
- [AccessControlHooks.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/access/accesscontrolhooks.sol.md): Function, event and error signatures for AccessControlHooks.sol.
- [IRoleProvider.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/access/iroleprovider.sol.md): Interface signatures for IRoleProvider.sol.
- [MarketConstraintHooks.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/access/marketconstrainthooks.sol.md): Function, event and error signatures for MarketConstraintHooks.sol.
- [/interfaces](https://docs.wildcat.finance/technical-overview/function-event-signatures/interfaces.md): Interface signatures for the core protocol interfaces.
- [IHooks.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/interfaces/ihooks.sol.md): Interface signatures for IHooks.sol.
- [IMarketEventsAndErrors.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/interfaces/imarketeventsanderrors.sol.md): Event and error signatures for IMarketEventsAndErrors.sol.
- [IWildcatArchController.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/interfaces/iwildcatarchcontroller.sol.md): Interface signatures for IWildcatArchController.sol.
- [IWildcatSanctionsEscrow.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/interfaces/iwildcatsanctionsescrow.sol.md): Interface signatures for IWildcatSanctionsEscrow.sol.
- [IWildcatSanctionsSentinel.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/interfaces/iwildcatsanctionssentinel.sol.md): Interface signatures for IWildcatSanctionsSentinel.sol.
- [/market](https://docs.wildcat.finance/technical-overview/function-event-signatures/market.md): Function, event and error signatures for the market contracts.
- [WildcatMarketConfig.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/market/wildcatmarketconfig.sol.md): Function, event and error signatures for WildcatMarketConfig.sol.
- [WildcatMarketToken.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/market/wildcatmarkettoken.sol.md): Function, event and error signatures for WildcatMarketToken.sol.
- [WildcatMarketWithdrawals.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/market/wildcatmarketwithdrawals.sol.md): Function, event and error signatures for WildcatMarketWithdrawals.sol.
- [WildcatMarketBase.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/market/wildcatmarketbase.sol.md): Function, event and error signatures for WildcatMarketBase.sol.
- [/spherex](https://docs.wildcat.finance/technical-overview/function-event-signatures/spherex.md): Function, event and error signatures for the SphereX integration contracts.
- [ISphereXEngine.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/spherex/ispherexengine.sol.md): Interface signatures for ISphereXEngine.sol.
- [ISphereXProtectedRegisteredBase.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/spherex/ispherexprotectedregisteredbase.sol.md): Interface signatures for ISphereXProtectedRegisteredBase.sol.
- [SphereXConfig.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/spherex/spherexconfig.sol.md): Function, event and error signatures for SphereXConfig.sol.
- [HooksFactory.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/hooksfactory.sol.md): Function, event and error signatures for HooksFactory.sol.
- [IHooksFactory.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/ihooksfactory.sol.md): Interface signatures for IHooksFactory.sol.
- [WildcatArchController.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/wildcatarchcontroller.sol.md): Function, event and error signatures for WildcatArchController.sol.
- [WildcatSanctionsEscrow.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/wildcatsanctionsescrow.sol.md): Function, event and error signatures for WildcatSanctionsEscrow.sol.
- [WildcatSanctionsSentinel.sol](https://docs.wildcat.finance/technical-overview/function-event-signatures/wildcatsanctionssentinel.sol.md): Function, event and error signatures for WildcatSanctionsSentinel.sol.
- [Protocol Structs](https://docs.wildcat.finance/technical-overview/protocol-structs.md): All V2 structs (MarketState, MarketParameters, WithdrawalBatch, and more) with their field types.
- [Contract Deployments](https://docs.wildcat.finance/technical-overview/contract-deployments.md): Core contract deployment addresses across chains — Ethereum mainnet, Plasma, and Sepolia testnet.
- [Code Security Reviews](https://docs.wildcat.finance/security-measures/code-security-reviews.md): Independent and Code4rena security reviews of the Wildcat V1 and V2 contracts, with reports.
- [SphereX Protection](https://docs.wildcat.finance/security-measures/spherex-protection.md): How Wildcat uses SphereX on-chain runtime protection to reject exploit-shaped transactions.
- [Bug Bounty Program](https://docs.wildcat.finance/security-measures/bug-bounty-program.md): Wildcat's Immunefi bug bounty (V1), its scope and reward tiers.
- [Proving You Are An Affected Lender in a Default](https://docs.wildcat.finance/security-measures/proving-you-are-an-affected-lender-in-a-default.md): How affected lenders use Juris to prove their position after a protocol-level default and ask the Wildcat Foundation for permitted borrower information.
- [Ripcord: Emergency Withdrawal Recovery](https://docs.wildcat.finance/security-measures/ripcord.md): Ripcord is a best-effort emergency tool that rescues a withdrawal already queued from a compromised lender wallet, executing it and forwarding the released funds to a safe wallet in one private, atomi
- [Wildcat Terms Of Use](https://docs.wildcat.finance/legal/wildcat-terms-of-use.md): Last Updated: 12 February 2025; SHA: 711a9e6707e6cf85166786461a0a45aa3b926b22b414abe8dfcc6c1afef020d1
- [Risk Disclosure Statement](https://docs.wildcat.finance/legal/risk-disclosure-statement.md): Updated and effective: 16 January 2025
- [Template MLA](https://docs.wildcat.finance/legal/master-loan-agreement.md): The optional open-source Master Loan Agreement template borrowers can attach to a market.
- [Privacy Policy](https://docs.wildcat.finance/legal/protocol-ui-privacy-policy.md): Updated and effective: 16 January 2025