🔐register_mercurial_vault_depository

Permissionned - Callable as long as the max number of registered mercurial vault depository isn't reached

Flow

• Checks

  • Anchor IDL accounts checks

  • Validates: same mint used for mercurial_vault.token_mint and collateral_mint

  • Validates: different mint used for collateral_mint and redeemable_mint

  • Validates: same decimals for collateral_mint and redeemable_mint

  • Validates: enforced mint used for collateral_mint (hardcoded as USDC:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v now)

• Handler

  • Initialises the depository PDA (MercurialVaultDepository)

  • Initialises the depository_lp_token_vault PDA

  • Write the depository PDA internal data

  • Update the controller PDA to link it with the newly registered depository

  • Emits Anchor RegisterMercurialVaultDepositoryEvent event

Specificities

Can register up to 8 of them as per the program limit MAX_REGISTERED_MERCURIAL_VAULT_DEPOSITORIES.

Can only be called with mints that are supported by Mercurial Vault, and should update the enforced mint checking with the given mint.

Parameters

minting_fee_in_bps - initial value of the fee collected by the authority

redeeming_fee_in_bps - initial value of the fee collected by the authority

redeemable_amount_under_management_cap - initial value of the max redeemable mint managed under this depository

Accounts input

programs/uxd/src/instructions/register_mercurial_vault_depository.rs/register_mango_depository.rs

// ...

#[derive(Accounts)]
pub struct RegisterMercurialVaultDepository<'info> {
    /// #1
    pub authority: Signer<'info>,

    /// #2
    #[account(mut)]
    pub payer: Signer<'info>,

    /// #3
    #[account(
        mut,
        seeds = [CONTROLLER_NAMESPACE],
        bump = controller.load()?.bump,
        has_one = authority @UxdError::InvalidAuthority,
    )]
    pub controller: AccountLoader<'info, Controller>,

    /// #4
    #[account(
        init,
        seeds = [MERCURIAL_VAULT_DEPOSITORY_NAMESPACE, mercurial_vault.key().as_ref(), collateral_mint.key().as_ref()],
        bump,
        payer = payer,
        space = MERCURIAL_VAULT_DEPOSITORY_SPACE,
    )]
    pub depository: AccountLoader<'info, MercurialVaultDepository>,

    /// #5
    pub collateral_mint: Box<Account<'info, Mint>>,

    /// #6
    #[account(
        constraint = mercurial_vault.lp_mint == mercurial_vault_lp_mint.key() @UxdError::InvalidMercurialVaultLpMint,
    )]
    pub mercurial_vault: Box<Account<'info, mercurial_vault::state::Vault>>,

    /// #7
    pub mercurial_vault_lp_mint: Box<Account<'info, Mint>>,

    /// #8
    /// Token account holding the LP tokens minted by depositing collateral on mercurial vault
    #[account(
        init,
        seeds = [MERCURIAL_VAULT_DEPOSITORY_LP_TOKEN_VAULT_NAMESPACE, mercurial_vault.key().as_ref(), collateral_mint.key().as_ref()],
        token::authority = depository,
        token::mint = mercurial_vault_lp_mint,
        bump,
        payer = payer,
    )]
    pub depository_lp_token_vault: Box<Account<'info, TokenAccount>>,

    /// #9
    pub system_program: Program<'info, System>,

    /// #10
    pub token_program: Program<'info, Token>,

    /// #11
    pub rent: Sysvar<'info, Rent>,
}
// ...