# 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