Builds referrer registration as one transaction when current net deposits
already meet the vault requirement. Otherwise it returns a deposit step and
a registration step that must be submitted after keeper netting processes
the deposit. A caller-specified depositAmount is never increased silently.
A zero referrerMinDepositAmount is the capital-light configuration: a new
partner can initialize and register atomically without depositing. With a
nonzero minimum, netDeposits changes only during keeper processing, so an
unqualified partner cannot deposit and register in the same transaction.
The generated gross amount covers both the effective deposit fee and the
vault's ordinary minimum deposit amount. depositInstructions is empty when
an existing pending net deposit already covers the referral minimum. An
existing inactive registration throws REFERRER_DEACTIVATED because the
registration instruction handler does not reactivate it.
Builds referrer registration as one transaction when current net deposits already meet the vault requirement. Otherwise it returns a deposit step and a registration step that must be submitted after keeper netting processes the deposit. A caller-specified
depositAmountis never increased silently.A zero
referrerMinDepositAmountis the capital-light configuration: a new partner can initialize and register atomically without depositing. With a nonzero minimum,netDepositschanges only during keeper processing, so an unqualified partner cannot deposit and register in the same transaction. The generated gross amount covers both the effective deposit fee and the vault's ordinary minimum deposit amount.depositInstructionsis empty when an existing pending net deposit already covers the referral minimum. An existing inactive registration throwsREFERRER_DEACTIVATEDbecause the registration instruction handler does not reactivate it.