본문으로 건너뛰기

마진 매니저 SDK

margin account를 관리하는 것은 DeepBook에서 leveraged trading을 수행하는 데 필수적이다. Margin Manager SDK는 margin manager 생성, collateral deposit, asset borrow, 그리고 risk 관리에 대한 함수를 제공한다.

Margin Manager functions​

DeepBook Margin SDK는 margin account를 관리하기 위한 다음 함수를 제공한다.

newMarginManager​

하나의 transaction에서 새 margin manager를 생성하고 공유하려면 newMarginManager를 사용한다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • poolKey: DeepBook pool을 식별하는 String이다.

newMarginManagerWithInitializer​

margin manager를 생성하고 initializer와 함께 반환하려면 newMarginManagerWithInitializer를 사용한다. 이후 이를 공유하기 위해 shareMarginManager를 호출해야 한다. 이 호출은 manager와 initializer를 포함하는 object를 반환한다.

매개변수

  • poolKey: DeepBook pool을 식별하는 String이다.

shareMarginManager​

newMarginManagerWithInitializer로 생성한 margin manager를 공유하려면 shareMarginManager를 사용한다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • poolKey: DeepBook pool을 식별하는 String이다.
  • manager: margin manager를 나타내는 TransactionArgument이다.
  • initializer: initializer를 나타내는 TransactionArgument이다.

depositDuringInitialization​

depositDuringInitialization을 사용해 margin manager 생성 중, 공유되기 전에 자금을 deposit한다. 이는 newMarginManagerWithInitializer와 같은 transaction 안에서, shareMarginManager보다 먼저 호출해야 한다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • manager: newMarginManagerWithInitializer가 반환한 margin manager를 나타내는 TransactionArgument이다.
  • poolKey: DeepBook pool을 식별하는 String이다.
  • coinType: deposit할 coin type을 식별하는 String이다(예: 'SUI', 'DBUSDC', 'DEEP').
  • amount: deposit할 amount를 나타내는 Number이다(amount 또는 coin 중 하나만 제공한다).
  • coin: deposit할 coin object를 나타내는 TransactionArgument이다(amount 또는 coin 중 하나만 제공한다).

depositBase, depositQuote, depositDeep​

이 함수를 사용해 margin manager에 asset을 deposit한다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • managerKey: margin manager를 식별하는 String이다.
  • amount: deposit할 amount를 나타내는 Number이다.

withdrawBase, withdrawQuote, withdrawDeep​

이 함수를 사용해 margin manager에서 asset을 인출한다. 인출은 risk ratio limit의 적용을 받는다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • managerKey: margin manager를 식별하는 String이다.
  • amount: 인출할 amount를 나타내는 Number이다.

borrowBase, borrowQuote​

이 함수를 사용해 margin pool에서 asset을 borrow한다. borrow는 risk ratio limit의 적용을 받는다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • managerKey: margin manager를 식별하는 String이다.
  • amount: borrow할 amount를 나타내는 Number이다.

repayBase, repayQuote​

이 함수를 사용해 borrow한 asset을 repay한다. amount를 지정하지 않으면, 총 debt까지 사용 가능한 최대 balance를 repay한다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • managerKey: margin manager를 식별하는 String이다.
  • amount: repay할 amount를 나타내는 optional Number이다.

liquidate​

담보가 부족한 margin manager를 liquidation하려면 liquidate를 사용한다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • managerAddress: liquidation할 margin manager의 address를 나타내는 String이다.
  • poolKey: DeepBook pool을 식별하는 String이다.
  • debtIsBase: debt가 base asset인지 여부를 나타내는 Boolean이다.
  • repayCoin: 상환에 사용할 coin을 나타내는 TransactionArgument이다.

setMarginManagerReferral​

margin manager에 대해 pool-specific referral을 설정하려면 setMarginManagerReferral을 사용한다. referral은 margin manager와 연관된 pool에 대해 mint된 DeepBookPoolReferral이어야 한다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • managerKey: margin manager를 식별하는 String이다.
  • referral: referral ID를 나타내는 String이다.

unsetMarginManagerReferral​

특정 pool에 대해 margin manager에서 referral 연관 관계를 제거하려면 unsetMarginManagerReferral을 사용한다. 이 호출은 Transaction object를 받는 함수를 반환한다.

매개변수

  • managerKey: margin manager를 식별하는 String이다.
  • poolKey: DeepBook pool을 식별하는 String이다.

read-only function​

다음 함수는 margin manager state를 수정하지 않고 쿼리한다.

managerState​

risk ratio, assets, debts, Pyth price data를 포함한 margin manager의 종합 state 정보를 쿼리한다.

owner, deepbookPool, marginPoolId​

기본적인 margin manager 정보를 쿼리한다.

baseBalance, quoteBalance, deepBalance​

Margin manager가 보유한 개별 asset balances를 쿼리한다.

borrowedShares, borrowedBaseShares, borrowedQuoteShares, hasBaseDebt​

borrowed position 정보를 쿼리한다.

balanceManager, calculateAssets, calculateDebts​

balance와 debt 정보를 쿼리한다.

예시​

다음 예시는 일반적인 margin manager operation을 시연한다.

margin manager 생성​

/**
 * @description 새 margin manager를 생성한다
 * @param {string} poolKey pool을 식별하는 키
 * @returns Transaction object를 받는 함수를 반환한다
 */
newMarginManager = (poolKey: string) => (tx: Transaction) => {};

// 예시 사용
createMarginManager = (tx: Transaction) => {
	const poolKey = 'SUI_DBUSDC';
	tx.add(this.marginContract.newMarginManager(poolKey));
};

collateral deposit​

// 예시: 담보로 SUI 100을 예치한다
depositCollateral = (tx: Transaction) => {
	const managerKey = 'MARGIN_MANAGER_1';
	tx.add(this.marginContract.depositBase(managerKey, 100));
};

asset borrow​

// 예시: USDC 500을 차입한다
borrowFunds = (tx: Transaction) => {
	const managerKey = 'MARGIN_MANAGER_1';
	tx.add(this.marginContract.borrowQuote(managerKey, 500));
};

loan repay​

// 예시: 차입한 모든 quote asset을 상환한다
repayLoan = (tx: Transaction) => {
	const managerKey = 'MARGIN_MANAGER_1';
	// amount를 지정하지 않으면 전부 상환한다
	tx.add(this.marginContract.repayQuote(managerKey));
};

position liquidate​

// 예시: 담보 부족 상태의 position을 청산한다
liquidatePosition = (tx: Transaction) => {
	const managerAddress = '0x...'; // 청산할 margin manager의 address
	const poolKey = 'SUI_DBUSDC';
	const debtIsBase = false; // 부채는 USDC(quote)이다
	const repayCoin = tx.splitCoins(tx.gas, [500 * 1_000_000]); // 금액은 USDC 500이다
	tx.add(this.marginContract.liquidate(managerAddress, poolKey, debtIsBase, repayCoin));
};