# Technical Docs & Code Repository

### Technical papers <a href="#technical-papers" id="technical-papers"></a>

[Whitepaper](https://bafybeibjommrelqjw22vewpddgfdnm5geoz747gv2zeuy7njwivpfcy3xa.ipfs.w3s.link/Liquity%20v2%20-%20Whitepaper%20rev.%200.3%20\(November%2C%202024\)%20\(1\).pdf)

### Code base <a href="#code-base" id="code-base"></a>

[Bold Core](https://github.com/liquity/bold) [Governance](https://github.com/liquity/V2-gov/tree/main)

### Audit reports <a href="#audit-reports" id="audit-reports"></a>

[ChainSecurity - Core Protocol Audit Report](https://www.chainsecurity.com/security-audit/liquity-bold-smart-contracts), December 2024

[Dedaub - Core Protocol Audit Report I](https://dedaub.com/audits/liquity/liquity-v2-aug-28-2024/), August 2024

[Dedaub - Core Protocol Audit Report II](https://dedaub.com/audits/liquity/liquity-v2-second-audit-nov-11-2024/), November 2024

[Certora - Formal Verification](https://certora.cdn.prismic.io/certora/Z1tLJJbqstJ98b8J_LiquityVerificationReport.pdf), December 2024

[Coinspect - Bold Core Smart Contract Audit](https://www.coinspect.com/doc/Coinspect%20-%20Smart%20Contract%20Audit%20-%20Liquity%20-%20Bold%20-%20v241231.pdf), December 2024

[Coinspect - Bold Governance Audit](https://www.coinspect.com/doc/Coinspect%20-%20Smart%20Contract%20Audit%20-%20Liquity%20-%20Bold%20Governance%20-%20v250120.pdf), January 2025

[ChainSecurity -Governance Smart Contract Audit](https://www.chainsecurity.com/security-audit/liquity-v2-governance), January 2025

[Dedaub - Governance Audit 1](https://dedaub.com/audits/liquity/liquity-v2-governance-1st-audit-aug-12-2024/), August 2024

[Dedaub - Governance Audit 2](https://dedaub.com/audits/liquity/liquity-v2-governance-2nd-audit-nov-11-2024/), November 2024

[Dedaub - Governance Audit 3](https://dedaub.com/audits/liquity/liquity-v2-governance-3rd-audit-dec-22-2024/), January 2025

### Economic modelling and simulation <a href="#economic-modelling-and-simulation" id="economic-modelling-and-simulation"></a>

[Chaos Labs: Mechanism Design Review](https://cdn.sanity.io/files/zmh9mnff/production/ca6a4815e62b05f33fb3ec56c5a4c42d6b7ddbec.pdf), October 2024

### Core Contract Addresses

* **DEFI Token:** 0x0883eA1df0E3a5630Be9aEdad4F2C1E2d0182593
* **USDFI Token**: 0xa0ed3359902eff692e5b8167038133a73d641909
* **Collateral Registry**: 0x1ec9287465ef04a7486779e81370c15624c939e8
* **Hint Helpers**: 0xa1557bf95e42ddb458b56c76530263495d067219
* **Multi Trove Getter**: 0x5db0ee97bb7bc82b025a3f65f2c4108577855955

### Protocol Constants

* **ETH Gas Compensation**: 0.0375 ETH
* **Interest Rate Adjustment Cooldown**: 7 days
* **Maximum Annual Interest Rate**: 250%
* **Minimum Annual Interest Rate**: 0.5%
* **Minimum Debt**: 2000 tokens
* **Stability Pool Yield Split**: 75%
* **Upfront Interest Period**: 7 days

## Contract Addresses <a href="#contract-addresses" id="contract-addresses"></a>

### FXS

* **Collateral Token**: 0x3432b6a60d23ca0dfca7761b7ab56459d9c964d0
* **Addresses Registry**: 0x58edc0621eacbe9a8d0d708287d3c13bb27cb459
* **Active Pool**: 0xafda3bda63bf2fdc7eca9a134e28c5626ec1dde0
* **Borrower Operations**: 0x74d7f2f3dac55831b75a0a152468665a7f5a6621
* **Collateral Surplus Pool**: 0x4d69b6672fc715f78a1f41e45e6f9b0dc1cd62c3
* **Default Pool**: 0xe0d8cb6703b02c72c05414b8e6bfe94c1f0674f3
* **Sorted Troves**: 0x95dd1379efa42557338dbd6c3417ecb6667b25e7
* **Stability Pool**: 0xcd4ebd6f318c19048509db8daf85a4af3542e64e
* **Trove Manager**: 0xa3ea296cb0ef46ebf093919bd408bd4e4f337f03
* **Trove NFT**: 0xd7eefc668772d38babbb266bd4859bd47a1f40df
* **Metadata NFT**: 0x9d75d13d5cf0e95a2afefe85505bb7f68ad91a0b
* **Price Feed**: 0x5860cf562dfb789a70d928b089fcb6770648db24
* **Gas Pool**: 0xf567c44f0796aef43b489e8514a89f2b90b5e347
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0x0ef7c21e115a09333f92c4899db8be367e8441e3
* **Leverage Zapper**: 0x0ef7c21e115a09333f92c4899db8be367e8441e3

### LINK&#x20;

* **Collateral Token**: 0x514910771af9ca656af840dff83e8264ecf986ca
* **Addresses Registry**: 0x9fc6ad9c5fa7e9e010e7a2535e6b8f061bd2c521
* **Active Pool**: 0xd5ddbf9be067133cfa19f893afa27d3ff56fb89d
* **Borrower Operations**: 0xd4bfe1af51fb89101ca9cec804d76017f2419bc4
* **Collateral Surplus Pool**: 0xe713131cb56c357b68b0795543dfbb1c5ccbcd14
* **Default Pool**: 0x1f747a0cdbf6253e0fa7cb75939c504b16130054
* **Sorted Troves**: 0x8fa078b8c96857844098ca890ad05439c8bf5817
* **Stability Pool**: 0xde41a35e454a0508d20ce246aff13970586b1e27
* **Trove Manager**: 0x8593ec30aee8dbed9df005e78d83f7b623ebeaa6
* **Trove NFT**: 0x559dfc2de8463d5fb45d8afedeec20a77e2c6883
* **Metadata NFT**: 0x5f07ea4bc193cc0b8af4af4cb0f1bf2d32beb78f
* **Price Feed**: 0xbc21070d7a0a8c12c57b43a0da337eec79741195
* **Gas Pool**: 0xe43e1c2121f402153f5e4ff36cc1b56c103305d2
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0x420815c23b03387866e89dc3e8cd168603cd8528
* **Leverage Zapper**: 0x420815c23b03387866e89dc3e8cd168603cd8528

### UNI

* **Collateral Token**: 0x1f9840a85d5af5bf1d1762f925bdaddc4201f984
* **Addresses Registry**: 0xcfa999437161563d5d8a91b1e37c5f0a2c439296
* **Active Pool**: 0xfef7e6471812c876e94ac3a93cab147d303e0159
* **Borrower Operations**: 0xa7317c72e5e58019ee79e2a9d021919d1d3da7eb
* **Collateral Surplus Pool**: 0x8d4e72533f9c8652a3f9297a97c98887e9fe584e
* **Default Pool**: 0x42ee97dd6148aec0d27254f9c126246e24dfe742
* **Sorted Troves**: 0x0cb12f03f11db49e1f55e9ad249a31759244b686
* **Stability Pool**: 0x8b93d8e6892c838832ca547c362dcffc62f6e854
* **Trove Manager**: 0x72bfd09d166891c253982f1eabb81f3260e46667
* **Trove NFT**: 0xe18b389f16893d86ef8299ffd05e5ca75de043f9
* **Metadata NFT**: 0xb9a26cb5840519fa74f729a7904cfff64fa6e72b
* **Price Feed**: 0xb58189b9543381216fb7c050ffa6e6c2b848bcf9
* **Gas Pool**: 0x798d918a5846d411098aed8668cd94b3aff922fb
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0x35b8e99987e086b98ca0f5111dda53eff7c549ee
* **Leverage Zapper**: 0x35b8e99987e086b98ca0f5111dda53eff7c549ee

### SKY

* **Collateral Token**: 0x56072c95faa701256059aa122697b133aded9279
* **Addresses Registry**: 0xeeaf41e63bcddf645f0719bec010944c5b493480
* **Active Pool**: 0xe9396dbd6bd9b0298980475772216165b2fe7bf9
* **Borrower Operations**: 0xf14f629f3e922f0562c7b691a6fe8c2175cbf4a2
* **Collateral Surplus Pool**: 0xffb588e31eb64b4cabb7f84b5995149b6b18869f
* **Default Pool**: 0x66eab81c82db69f454608366871b44ed2dd711a2
* **Sorted Troves**: 0x216db6b694ed79b49e170a145288b1fe5ddf1cc8
* **Stability Pool**: 0x45fdabb2eb0f10ffe192eda92af1f58eee6d393c
* **Trove Manager**: 0xfe69417cc583ea9f4335be92c325e7cdc5def499
* **Trove NFT**: 0xdcbedba4ec1d0caab9877d2c66a865c932247ce4
* **Metadata NFT**: 0xef06e61fc136a38acbf0d268402626efc4a301dc
* **Price Feed**: 0x7ec4e404e2c3209f072e20ea2cfca80edbc56038
* **Gas Pool**: 0xcc3cd87284b794b53821cff5f97fbc4d98226108
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0x680d1ffe1aeb199a7d2e6a6764a2a80231db51f8
* **Leverage Zapper**: 0x680d1ffe1aeb199a7d2e6a6764a2a80231db51f8

### CRV

* **Collateral Token**: 0xd533a949740bb3306d119cc777fa900ba034cd52
* **Addresses Registry**: 0xaa28653a8e8e040198dccbcc41e622bc7da67eaf
* **Active Pool**: 0xca51e5c32f63dfaaa74c4be4a63e830b0c10aee0
* **Borrower Operations**: 0xb8ff8fa35bdc415658f73619ac95ebd9072b710c
* **Collateral Surplus Pool**: 0x6044ce04cc13574fda99dbb02bd3d38ede28c857
* **Default Pool**: 0x7ece962b9f412f6a593315e7756a853019953712
* **Sorted Troves**: 0x586ca75dd980f193d374c3ed691f196a4e2688ea
* **Stability Pool**: 0x2c145aa00d9cef896f7fb99a9fb07d935976e3b3
* **Trove Manager**: 0x7c103815b2264e556bcc1d1c446a8c7dc677a17e
* **Trove NFT**: 0x99d8a1e89da15f5c2fd954808483a9b192d5a807
* **Metadata NFT**: 0x6d49722a526592bd614ab0d25803e0191d51fae3
* **Price Feed**: 0x74a71272b9f71e667da6d2988120c909f23cecc5
* **Gas Pool**: 0x90fe3006f7688feed26ff363888203aed177707b
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0x1784b9cf74a120a598005cbf912fdbb09021fc03
* **Leverage Zapper**: 0x1784b9cf74a120a598005cbf912fdbb09021fc03

### AAVE

* **Collateral Token**: 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9
* **Addresses Registry**: 0x9f95ea2198a1d47d752b5a1e6ec0524b22bf0ed3
* **Active Pool**: 0x6dac843b1045bd17892f0a612797950e0b441bb9
* **Borrower Operations**: 0x27046382bf4038aeadce9ef55dc2a1ddde40cde5
* **Collateral Surplus Pool**: 0x80ed1a92ac613f5bbd6d5e8be93587a15f8c7910
* **Default Pool**: 0x299b2cd95d6f6e21511109648e9a99dcadd0766a
* **Sorted Troves**: 0xf11da023d236cc7fdc5f4ee24bdff69d144d8d55
* **Stability Pool**: 0xf0198e08d33a97853b7e6ea7c7dc7e975d5c261c
* **Trove Manager**: 0x7f7a7c8fa49584b81ca922b594de658a9c1ca98a
* **Trove NFT**: 0x3665fc2c2d7b4682eb8ce676a09a71239366f045
* **Metadata NFT**: 0xb4c88e48325faf5dbf1654c9f233a89b2712643b
* **Price Feed**: 0xa931451e5e9937a35574b1f3aa286dd9cbc5cbac
* **Gas Pool**: 0xccc0155b5fa766b69f57e66ff4111baccd7d3adc
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0xf70c92df15bf7f9c1b451ed53d653a1fa9b60795
* **Leverage Zapper**: 0xf70c92df15bf7f9c1b451ed53d653a1fa9b60795

### YFI

* **Collateral Token**: 0x0bc529c00c6401aef6d220be8c6ea1667f6ad93e
* **Addresses Registry**: 0xa56d1ca0fa3a205725e26fab322c4f5423163178
* **Active Pool**: 0x3e69e49418064341c36c7fd9a97440714a019d48
* **Borrower Operations**: 0x7b6ca435720829dae4ce8264a467f02b0737d879
* **Collateral Surplus Pool**: 0x8cb4298825999ab50af39aa7637b222922b63284
* **Default Pool**: 0x5002c04906ae6af0da18c777f3a5e397496a40e5
* **Sorted Troves**: 0x49ca0a1c7da3d8625dd62e2a1717bfae9082dc8c
* **Stability Pool**: 0xa72f1f5c00e64e68fddef30a0c2438d053fc666b
* **Trove Manager**: 0xa75378f271405eb53ef1c4827ef10a8048af8c1a
* **Trove NFT**: 0xe3a0cf7166a45e8715d6f35c29bbab83848ce26a
* **Metadata NFT**: 0x2e4913d5485116a59ad2794bc31d6213b5a6eddf
* **Price Feed**: 0x68cd607f783fcbe5ae50ed470aa3b447b49e3c47
* **Gas Pool**: 0x94d1ad14453857ee5237266317b3fa3300a80be8
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0xd10a5dd2f8e8e2bcecb9a2ee5e21c624892121b7
* **Leverage Zapper**: 0xd10a5dd2f8e8e2bcecb9a2ee5e21c624892121b7

### LDO

* **Collateral Token**: 0x5a98fcbea516cf06857215779fd812ca3bef1b32
* **Addresses Registry**: 0x3b9e6af83705a7e01cc557746ba1573ebffa2f5c
* **Active Pool**: 0x6a9a25e002129ade67a0ef2e58a35e04e10b1edc
* **Borrower Operations**: 0x60b6a5a67bbb2bef72e1dbb1ce22c5092af84d29
* **Collateral Surplus Pool**: 0xd124c44e465798ef59b4cbb2ea46933383301173
* **Default Pool**: 0xa9aca2785fd9c9eb10d562f45e0657f0de59510e
* **Sorted Troves**: 0xdf50ffa4afacb1fb4e821b07f51798232005e910
* **Stability Pool**: 0xdee019f44c33940fb64889f8f8e475a6dc87973d
* **Trove Manager**: 0x5ff5db53c68f288f5dc57e6b2eb4dcc80ec37485
* **Trove NFT**: 0x6446566ccd8a27dc38cffaca79e502036b0074c7
* **Metadata NFT**: 0x83be18b2dbb30229d70d13c17cff798d7481b729
* **Price Feed**: 0x8fc0ed79d7d58ec1541bb65f9d2a423e3035ed49
* **Gas Pool**: 0xf87430d6fa2274a5f565e243136fa6666f82a984
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0x3e7f74ebd184d9eb44beb6b4fe69ceeae1051576
* **Leverage Zapper**: 0x3e7f74ebd184d9eb44beb6b4fe69ceeae1051576

### LQTY

* **Collateral Token**: 0x6dea81c8171d0ba574754ef6f8b412f2ed88c54d
* **Addresses Registry**: 0x8f863ca01b6a688df237c6c233e2e3b17009c881
* **Active Pool**: 0x1c627f3f096f53f3ea51878e0907a6664e5b9844
* **Borrower Operations**: 0x376466c5aaec6dfa888bbb5523a6510788617246
* **Collateral Surplus Pool**: 0xcb0ee2631ff9382ecc2a347b4b72073ce30ad669
* **Default Pool**: 0xf04b8374f4543863407dd157e596509e2d845c6a
* **Sorted Troves**: 0x88f48a2993ebe1dc1e2a4a879bd50a2e61a746c9
* **Stability Pool**: 0xc64fd2b3a948658698250a3b51946ecc3880f32d
* **Trove Manager**: 0xbeb4609ffff4ee01f31019a7fd6525e823ac0dfe
* **Trove NFT**: 0x521217a51fcbe0e4df3f8f89ad8aa0453e4fa1d2
* **Metadata NFT**: 0x95082e5dc37efcae44888d9964f690d4079da440
* **Price Feed**: 0xcd0700037754ea9bca3877ad970e20dc3eaf8b6d
* **Gas Pool**: 0x5a2621accf0014d3d58c93a3bdff29f26e71caba
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0xe3f0cb37cea75af068557b32a395c50adfe64560
* **Leverage Zapper**: 0xe3f0cb37cea75af068557b32a395c50adfe64560

### WBTC

* **Collateral Token**: 0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
* **Addresses Registry**: 0x531f506435efb1c9f9bebadfee2eb179563ef1b2
* **Active Pool**: 0x2e4d932afaee7b88b39bf0665af307982ba88a9b
* **Borrower Operations**: 0xc94fb896b392ff1264060f5e1e91b71681d47819
* **Collateral Surplus Pool**: 0x88cba6a2a74157bc8473b34e697fb37458cfcbc4
* **Default Pool**: 0xc48599ded8dd1063044e83709709bcff4fe42e09
* **Sorted Troves**: 0x09b7bb4752c03c63eee8c32d034cb2612f493e9d
* **Stability Pool**: 0xcac3c0647868f041d1005adaf14920dfcc2b6969
* **Trove Manager**: 0x8b1eeba73fb9b385d2589a16307e29ae580387df
* **Trove NFT**: 0x709dc0cad52cc74d376613b861936c301300b2e1
* **Metadata NFT**: 0x6e8a088205436fe6e5e1f7e599d1202122958142
* **Price Feed**: 0xba1ae98ef8c0857f8a657f03b44ed31a4d0d921e
* **Gas Pool**: 0x0da5b5a4b5dee905352d088e6157e4b211ad5c5e
* **Interest Router**: 0x0268d016717884632a7fd05043687cef2e51137f
* **Gas Comp Zapper**: 0xc4cc6b5d7dfb2c6515f3eb8fa4c8f80fab4773af
* **Leverage Zapper**: 0xc4cc6b5d7dfb2c6515f3eb8fa4c8f80fab4773af


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.defidollar.io/documentation/technical-docs-and-code-repository.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.