> For the complete documentation index, see [llms.txt](https://ipusd.gitbook.io/ipusd-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ipusd.gitbook.io/ipusd-docs/technical-reference/contracts-roles-and-disclosures.md).

# Contracts, Roles, and Disclosures

### Soneium mainnet contracts

| Contract                | Address                                                                                                |
| ----------------------- | ------------------------------------------------------------------------------------------------------ |
| IPUSD Token             | [`0x9dB3...5cd0 ↗`](https://soneium.blockscout.com/address/0x9dB3DDb02159E57b5078317a2391Bc3c94eF5cd0) |
| IPUSDWrapper (proxy)    | [`0xef63...93C4 ↗`](https://soneium.blockscout.com/address/0xef63d926A0d15e6e7d96d767665f9312Cb7993C4) |
| IPUSDAddressProvider    | [`0xe66A...46dB ↗`](https://soneium.blockscout.com/address/0xe66ACE2989C08efff4663FFA0370dFdD92FD46dB) |
| IPUSDACLManager         | [`0xBb59...8a17 ↗`](https://soneium.blockscout.com/address/0xBb59AE89eb8B59DeaC85d6eD68356AE58Ea78a17) |
| IP Vault (proxy)        | [`0x2Ba3...bCd9 ↗`](https://soneium.blockscout.com/address/0x2Ba3FC5BDbBE7BE2630fB71e759739625246bCd9) |
| PreDeposit (proxy)      | [`0xAB40...8255 ↗`](https://soneium.blockscout.com/address/0xAB407CE7242C08d5B876F3faFCBf94e537fE8255) |
| PreDepositLens          | [`0x6067...e04d ↗`](https://soneium.blockscout.com/address/0x606756BAF76C97E92AaB67a422F1578C7E87e04d) |
| RedeemQueue (proxy)     | [`0x504c...3068 ↗`](https://soneium.blockscout.com/address/0x504c9A94B43c9B536452823DE53541F666c23068) |
| RwaManager              | [`0x741a...8e31 ↗`](https://soneium.blockscout.com/address/0x741a926c6FaE0f357aB0194DcE770767B21D8e31) |
| AdminTimelock           | [`0x9215...B77F ↗`](https://soneium.blockscout.com/address/0x921530D47da54b3461704A804b4F9E686989B77F) |
| ProtocolLens            | [`0x6830...A3D5 ↗`](https://soneium.blockscout.com/address/0x683090B1B01f8fb268E62e7c0742F2a00bA6A3D5) |
| Administrative multisig | [`0xc7ef...77c4 ↗`](https://soneium.blockscout.com/address/0xc7efCF39c0722a0d27f101cc79Fd00420bf077c4) |

<details>

<summary><strong>Implementation and library contracts</strong></summary>

The following addresses are implementation or library contracts used by the deployed protocol. Users should interact with the corresponding proxy contracts where applicable.

| Contract                    | Address                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------ |
| IPUSDWrapper Implementation | [`0xA337...6F09 ↗`](https://soneium.blockscout.com/address/0xA3374dE89C2ace31B9961aF5aae07a8bde686F09) |
| IP Vault Implementation     | [`0x8CfD...3e73 ↗`](https://soneium.blockscout.com/address/0x8CfDe91D3a4c55b426732f17dF1745E6d0603e73) |
| PreDeposit Implementation   | [`0x1aA3...8c22 ↗`](https://soneium.blockscout.com/address/0x1aA37323b03964765B37a51A841F416B74558c22) |
| PreDepositLib               | [`0xA59b...39c2 ↗`](https://soneium.blockscout.com/address/0xA59b152664efeFFEaF8780cc9d10a2cCb87739c2) |
| RedeemQueue Implementation  | [`0xb04A...8274 ↗`](https://soneium.blockscout.com/address/0xb04AF5Ef7fc6C4ACAAA559273B4571fBe6618274) |

</details>

### Administrative roles

| Role               | High-level responsibility                                                                                               |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| Governance / Admin | RWA registration, valuation sources, RWA extractions, core configuration, addresses, roles, and upgrades                |
| Operator           | Rounds, Settlement Capacity, Standard Withdrawal Capacity, Instant Withdrawal parameters, and settlement reconciliation |
| Guardian           | Emergency pauses, immediate disablement of Instant Withdrawal, and cancellation of pending Timelock operations          |

The contracts do not define a separate Valuation Reviewer role.

`ROLE_SETTLE` is an internal Timelock policy label and does not represent a separate user-facing role or signer group.

### Timelock configuration

| Network         | `DELAY`                  | `handoffDelay`            |
| --------------- | ------------------------ | ------------------------- |
| Soneium mainnet | 600 seconds (10 minutes) | 86,400 seconds (24 hours) |

The `DELAY` value can be updated by the authorized Admin Safe through `setDelay()`. The current `DELAY` is 600 seconds (10 minutes), and the current `handoffDelay` is 86,400 seconds (24 hours).

After an operation reaches its execution time, any address may execute the originally scheduled calldata. The executor cannot modify the approved parameters.

### Multisig configuration

Administrative actions are authorized through multisig controls. Signer configuration and approval thresholds may change over time through the applicable governance process.

| Role / Control                   | Address                                                                                                 |
| -------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Governance / Admin (ipUSD admin) | [`0xc7ef...77c4 ↗`](https://soneium.blockscout.com/address/0xc7efCF39c0722a0d27f101cc79Fd00420bf077c4)  |
| Operator (ipUSD ops manager)     | [`0x2EA3...a25f4 ↗`](https://soneium.blockscout.com/address/0x2EA32b7cA8e58640561696A25045D9B5B58a25f4) |
| Guardian (ipUSD guardian)        | [`0x64C6...2bBf6 ↗`](https://soneium.blockscout.com/address/0x64C6B26D57f819f02db8D1e6158f53FaC3a2bBf6) |

Governance, Operator, and Guardian are separate protocol roles with distinct permissions and responsibilities.

Safe signer lists and thresholds are stored in the relevant Safe contracts rather than in the AdminTimelock.

### Current RWA position

| Information                          | Current value                                                |
| ------------------------------------ | ------------------------------------------------------------ |
| Underlying strategy                  | Partners Group Diversified Royalties Opportunities           |
| IP Vault underlying fund             | Partners Group Diversified Royalties Opportunities Evergreen |
| Asset manager                        | Partners Group                                               |
| Tokenization / distribution platform | Asseto                                                       |
