@scallop-io/scallop-deepbook-kit 0.1.3 → 0.1.5-rc.1

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _mysten_deepbook_v3 from '@mysten/deepbook-v3';
-import { MarginPoolContract, DeepBookConfig } from '@mysten/deepbook-v3';
+import { DeepBookConfig, MarginPoolContract } from '@mysten/deepbook-v3';
 import { SuiClient } from '@mysten/sui/client';
 import { Transaction } from '@mysten/sui/transactions';
 
@@ -10,6 +10,8 @@ interface ToolkitConfig {
     privateKey: string;
     supplierCapId?: string;
     fullnodeUrl?: string;
+    supplierCapPackageId?: string;
+    dbConfig?: DeepBookConfig;
 }
 interface TransactionResult {
     digest: string;
@@ -33,7 +35,9 @@ declare class DeepBookMarginToolkit {
     private address;
     private marginPoolContract;
     private supplierCapId?;
-    constructor(config: ToolkitConfig);
+    private dbConfig;
+    private supplierCapPackageId;
+    constructor({ network, fullnodeUrl, supplierCapId, privateKey, supplierCapPackageId, dbConfig, }: ToolkitConfig);
     initialize(): Promise<string>;
     createSupplierCap(): Promise<string | null>;
     createSupplyReferral(coin: MarginCoinType): Promise<string | null>;
@@ -47,17 +51,16 @@ declare class DeepBookMarginToolkit {
 
 declare const MARGIN_POOL_PARAM_KEYS: readonly ["supplyCap", "maxUtilizationRate", "protocolSpread", "minBorrow", "interestRate", "totalSupply", "supplyShares", "totalBorrow", "borrowShares", "lastUpdateTimestamp"];
 declare const MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS: readonly ["userSupplyShares", "userSupplyAmount"];
-
 type MarginPoolParamKey = (typeof MARGIN_POOL_PARAM_KEYS)[number];
 type MarginPoolWithSupplierCapParamKey = (typeof MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS)[number];
+
 type InterestConfig = {
-    midKink: number;
     highKink: number;
     baseBorrowApr: number;
-    midBorrowApr: number;
-    highBorrowApr: number;
+    borrowAprOnHighKink: number;
     maxBorrowApr: number;
-    borrowApr: number;
+    supplyApr: number;
+    utilizationRate: number;
 };
 type MarginPoolParams = Record<MarginPoolParamKey | MarginPoolWithSupplierCapParamKey, number> & InterestConfig & {
     address: string;
@@ -65,12 +68,18 @@ type MarginPoolParams = Record<MarginPoolParamKey | MarginPoolWithSupplierCapPar
     scalar: number;
     decimals: number;
 };
+type DeepBookMarginPoolParams = {
+    address?: string;
+    suiClient?: SuiClient;
+    env?: NetworkType;
+    dbConfig?: DeepBookConfig;
+};
 declare class DeepBookMarginPool {
     #private;
-    readonly suiClient: SuiClient;
     marginPoolContract: MarginPoolContract;
     dbConfig: DeepBookConfig;
-    constructor(env?: NetworkType, address?: string, suiClient?: SuiClient, dbConfig?: DeepBookConfig);
+    suiClient: SuiClient;
+    constructor({ env, address, suiClient, dbConfig, }?: DeepBookMarginPoolParams);
     get env(): _mysten_deepbook_v3.Environment;
     getPoolParameters(coinKey: string, supplierCapId?: string, tx?: Transaction): Promise<MarginPoolParams>;
     getPoolParameters(coinKey: string, supplierCapId: string | undefined, tx: Transaction, inspect: true): Promise<MarginPoolParams>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _mysten_deepbook_v3 from '@mysten/deepbook-v3';
-import { MarginPoolContract, DeepBookConfig } from '@mysten/deepbook-v3';
+import { DeepBookConfig, MarginPoolContract } from '@mysten/deepbook-v3';
 import { SuiClient } from '@mysten/sui/client';
 import { Transaction } from '@mysten/sui/transactions';
 
@@ -10,6 +10,8 @@ interface ToolkitConfig {
     privateKey: string;
     supplierCapId?: string;
     fullnodeUrl?: string;
+    supplierCapPackageId?: string;
+    dbConfig?: DeepBookConfig;
 }
 interface TransactionResult {
     digest: string;
@@ -33,7 +35,9 @@ declare class DeepBookMarginToolkit {
     private address;
     private marginPoolContract;
     private supplierCapId?;
-    constructor(config: ToolkitConfig);
+    private dbConfig;
+    private supplierCapPackageId;
+    constructor({ network, fullnodeUrl, supplierCapId, privateKey, supplierCapPackageId, dbConfig, }: ToolkitConfig);
     initialize(): Promise<string>;
     createSupplierCap(): Promise<string | null>;
     createSupplyReferral(coin: MarginCoinType): Promise<string | null>;
@@ -47,17 +51,16 @@ declare class DeepBookMarginToolkit {
 
 declare const MARGIN_POOL_PARAM_KEYS: readonly ["supplyCap", "maxUtilizationRate", "protocolSpread", "minBorrow", "interestRate", "totalSupply", "supplyShares", "totalBorrow", "borrowShares", "lastUpdateTimestamp"];
 declare const MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS: readonly ["userSupplyShares", "userSupplyAmount"];
-
 type MarginPoolParamKey = (typeof MARGIN_POOL_PARAM_KEYS)[number];
 type MarginPoolWithSupplierCapParamKey = (typeof MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS)[number];
+
 type InterestConfig = {
-    midKink: number;
     highKink: number;
     baseBorrowApr: number;
-    midBorrowApr: number;
-    highBorrowApr: number;
+    borrowAprOnHighKink: number;
     maxBorrowApr: number;
-    borrowApr: number;
+    supplyApr: number;
+    utilizationRate: number;
 };
 type MarginPoolParams = Record<MarginPoolParamKey | MarginPoolWithSupplierCapParamKey, number> & InterestConfig & {
     address: string;
@@ -65,12 +68,18 @@ type MarginPoolParams = Record<MarginPoolParamKey | MarginPoolWithSupplierCapPar
     scalar: number;
     decimals: number;
 };
+type DeepBookMarginPoolParams = {
+    address?: string;
+    suiClient?: SuiClient;
+    env?: NetworkType;
+    dbConfig?: DeepBookConfig;
+};
 declare class DeepBookMarginPool {
     #private;
-    readonly suiClient: SuiClient;
     marginPoolContract: MarginPoolContract;
     dbConfig: DeepBookConfig;
-    constructor(env?: NetworkType, address?: string, suiClient?: SuiClient, dbConfig?: DeepBookConfig);
+    suiClient: SuiClient;
+    constructor({ env, address, suiClient, dbConfig, }?: DeepBookMarginPoolParams);
     get env(): _mysten_deepbook_v3.Environment;
     getPoolParameters(coinKey: string, supplierCapId?: string, tx?: Transaction): Promise<MarginPoolParams>;
     getPoolParameters(coinKey: string, supplierCapId: string | undefined, tx: Transaction, inspect: true): Promise<MarginPoolParams>;

package/dist/index.js

@@ -1 +1 @@
-'use strict';var client=require('@mysten/sui/client'),ed25519=require('@mysten/sui/keypairs/ed25519'),transactions=require('@mysten/sui/transactions'),deepbookV3=require('@mysten/deepbook-v3'),cryptography=require('@mysten/sui/cryptography'),bcs$1=require('@mysten/bcs'),bcs=require('@mysten/sui/bcs'),bignumber_js=require('bignumber.js');var D={MARGIN_INITIAL_PACKAGE_ID:"0x7f2d8f15343f210e813595a8798d6197d152061d0a35be938372f4b1cd66f209"},c={DEEP:{address:"0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8",type:"0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP",scalar:1e6,decimals:6},SUI:{address:"0x0000000000000000000000000000000000000000000000000000000000000002",type:"0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",scalar:1e9,decimals:9},DBUSDC:{address:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7",type:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7::DBUSDC::DBUSDC",scalar:1e6,decimals:6},DBUSDT:{address:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7",type:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7::DBUSDT::DBUSDT",scalar:1e6,decimals:6},WAL:{address:"0x9ef7676a9f81937a52ae4b2af8d511a28a0b080477c0c2db40b0ab8882240d76",type:"0x9ef7676a9f81937a52ae4b2af8d511a28a0b080477c0c2db40b0ab8882240d76::wal::WAL",scalar:1e9,decimals:9}},f={DEEP_SUI:{address:"0x48c95963e9eac37a316b7ae04a0deb761bcdcc2b67912374d6036e7f0e9bae9f",baseCoin:"DEEP",quoteCoin:"SUI",lotSize:1e6,tickSize:1e6},SUI_DBUSDC:{address:"0x1c19362ca52b8ffd7a33cee805a67d40f31e6ba303753fd3a4cfdfacea7163a5",baseCoin:"SUI",quoteCoin:"DBUSDC",lotSize:1e6,tickSize:1e3},DEEP_DBUSDC:{address:"0xe86b991f8632217505fd859445f9803967ac84a9d4a1219065bf191fcb74b622",baseCoin:"DEEP",quoteCoin:"DBUSDC",lotSize:1e6,tickSize:1e3},DBUSDT_DBUSDC:{address:"0x83970bb02e3636efdff8c141ab06af5e3c9a22e2f74d7f02a9c3430d0d10c1ca",baseCoin:"DBUSDT",quoteCoin:"DBUSDC",lotSize:1e6,tickSize:1e3},WAL_DBUSDC:{address:"0xeb524b6aea0ec4b494878582e0b78924208339d360b62aec4a8ecd4031520dbb",baseCoin:"WAL",quoteCoin:"DBUSDC",lotSize:1e6,tickSize:1e3},WAL_SUI:{address:"0x8c1c1b186c4fddab1ebd53e0895a36c1d1b3b9a77cd34e607bef49a38af0150a",baseCoin:"WAL",quoteCoin:"SUI",lotSize:1e6,tickSize:1e6}},d={SUI:{address:"0xe620d6a5390e57e88baff18af89383130d4210eb496a024edcd62f270a655af7",coinType:"0x2::sui::SUI"},DBUSDC:{address:"0xfd0dc290a120ad6c534507614d4dc0b2e78baab649c35bfacbaec2ce18140b69",coinType:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7::DBUSDC::DBUSDC"}};var P=["supplyCap","maxUtilizationRate","protocolSpread","minBorrow","interestRate","totalSupply","supplyShares","totalBorrow","borrowShares","lastUpdateTimestamp"],b=["userSupplyShares","userSupplyAmount"],B={supplyCap:"U64",maxUtilizationRate:"U64",protocolSpread:"U64",minBorrow:"U64",interestRate:"U64",totalSupply:"U64",supplyShares:"U64",totalBorrow:"U64",borrowShares:"U64",lastUpdateTimestamp:"U64",userSupplyShares:"U64",userSupplyAmount:"U64"};var k=n=>/^0x[0-9a-fA-F]+$|^[0-9a-fA-F]+$/.test(n),L=n=>/^[a-zA-Z0-9+/]+={0,2}$/g.test(n),x=n=>{if(k(n))return bcs$1.fromHex(n);if(L(n))return bcs$1.fromBase64(n);throw new Error("The string is not a valid hex or base64 string.")},_=n=>{if(n.length===cryptography.LEGACY_PRIVATE_KEY_SIZE)return n.slice(0,cryptography.PRIVATE_KEY_SIZE);if(n.length===cryptography.PRIVATE_KEY_SIZE+1&&n[0]===0)return n.slice(1);if(n.length===cryptography.PRIVATE_KEY_SIZE)return n;throw new Error("invalid secret key")};var w=class{suiClient;keypair;address;marginPoolContract;supplierCapId;constructor(r){let a=r.fullnodeUrl??client.getFullnodeUrl(r.network);this.suiClient=new client.SuiClient({url:a}),this.keypair=this.#r(r.privateKey),this.address=this.keypair.getPublicKey().toSuiAddress(),this.supplierCapId=r.supplierCapId;let e={DEEP:{address:c.DEEP.address,type:c.DEEP.type,scalar:c.DEEP.scalar},SUI:{address:c.SUI.address,type:c.SUI.type,scalar:c.SUI.scalar},DBUSDC:{address:c.DBUSDC.address,type:c.DBUSDC.type,scalar:c.DBUSDC.scalar}},t={SUI_DBUSDC:{address:f.SUI_DBUSDC.address,baseCoin:f.SUI_DBUSDC.baseCoin,quoteCoin:f.SUI_DBUSDC.quoteCoin}},i={SUI:{address:d.SUI.address,type:d.SUI.coinType},DBUSDC:{address:d.DBUSDC.address,type:d.DBUSDC.coinType}},o=new deepbookV3.DeepBookConfig({address:this.address,env:r.network,coins:e,pools:t,marginPools:i});this.marginPoolContract=new deepbookV3.MarginPoolContract(o);}#r(r){if(r.startsWith(cryptography.SUI_PRIVATE_KEY_PREFIX)){let{secretKey:a}=cryptography.decodeSuiPrivateKey(r);return ed25519.Ed25519Keypair.fromSecretKey(_(a))}return ed25519.Ed25519Keypair.fromSecretKey(_(x(r)))}async#e(){let r=`${D.MARGIN_INITIAL_PACKAGE_ID}::margin_pool::SupplierCap`;return (await this.suiClient.getOwnedObjects({owner:this.address,filter:{StructType:r},options:{showType:true}})).data?.[0]?.data?.objectId}async initialize(){if(this.supplierCapId)return this.supplierCapId;let r=await this.#e();if(r)return this.supplierCapId=r,r;let a=await this.createSupplierCap();if(!a)throw new Error("Failed to create Supplier Cap");return this.supplierCapId=a,a}async createSupplierCap(){try{let r=new transactions.Transaction,a=this.marginPoolContract.mintSupplierCap()(r);r.transferObjects([a],this.address);let e=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:r,options:{showEffects:!0,showObjectChanges:!0}});if(e.errors&&e.errors.length>0)throw new Error(`Transaction failed with errors: ${e.errors.map(t=>t.toString()).join(", ")}`);if(e.objectChanges){for(let t of e.objectChanges)if(t.type==="created"&&t.objectType.includes("SupplierCap"))return t.objectId}return null}catch(r){throw new Error(`Failed to create Supplier Cap: ${r.message||r}`)}}async createSupplyReferral(r){try{let a=new transactions.Transaction;this.marginPoolContract.mintSupplyReferral(r)(a);let e=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:a,options:{showEffects:!0,showObjectChanges:!0}});if(e.errors&&e.errors.length>0)throw new Error(`Transaction failed with errors: ${e.errors.map(t=>t.toString()).join(", ")}`);if(e.objectChanges){for(let t of e.objectChanges)if(t.type==="created"&&t.objectType.includes("SupplyReferral"))return t.objectId}return null}catch(a){throw new Error(`Failed to create Supply Referral: ${a.message||a}`)}}async supplyToMarginPool(r,a,e){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let t=new transactions.Transaction;t.setSender(this.address);let i=t.object(this.supplierCapId);t.add(this.marginPoolContract.supplyToMarginPool(r,i,a,e));let{errors:o}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:t,options:{showEffects:!0,showObjectChanges:!0}});if(o&&o.length>0)throw new Error(`Transaction failed with errors: ${o.map(s=>s.toString()).join(", ")}`);return !0}catch(t){throw new Error(`Failed to supply to margin pool: ${t.message||t}`)}}async withdrawFromMarginPool(r,a){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let e=new transactions.Transaction,t=e.object(this.supplierCapId),o=this.marginPoolContract.withdrawFromMarginPool(r,t,a)(e);e.transferObjects([o],this.address);let{errors:s}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:e,options:{showEffects:!0,showObjectChanges:!0}});if(s&&s.length>0)throw new Error(`Transaction failed with errors: ${s.map(l=>l.toString()).join(", ")}`);return !0}catch(e){throw new Error(`Failed to withdraw from margin pool: ${e.message||e}`)}}async withdrawReferralFees(r,a){try{let e=new transactions.Transaction;e.add(this.marginPoolContract.withdrawReferralFees(r,a));let{errors:t}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:e,options:{showEffects:!0,showObjectChanges:!0,showBalanceChanges:!0}});if(t&&t.length>0)throw new Error(`Transaction failed with errors: ${t.map(i=>i.toString()).join(", ")}`);return !0}catch(e){throw new Error(`Failed to withdraw referral fees: ${e.message||e}`)}}async getBalance(r){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let a=new transactions.Transaction;a.add(this.marginPoolContract.userSupplyAmount(r,this.supplierCapId));let e=await this.suiClient.devInspectTransactionBlock({sender:this.address,transactionBlock:a}),t=0;if(e&&e.results&&e.results[0]&&e.results[0].returnValues){let p=e.results[0].returnValues[0];if(p&&p[0]){let m=Buffer.from(p[0]).readBigUInt64LE(),C=r==="SUI"?c.SUI.scalar:c.DBUSDC.scalar;t=Number(m)/C;}}let i=r==="SUI"?c.SUI.type:c.DBUSDC.type,o=await this.suiClient.getBalance({owner:this.address,coinType:i}),s=r==="SUI"?c.SUI.scalar:c.DBUSDC.scalar,l=Number(o.totalBalance)/s;return {userSupplyAmount:t,walletBalance:l}}catch(a){throw new Error(`Failed to get balance: ${a.message||a}`)}}getSupplierCapId(){return this.supplierCapId}getAddress(){return this.address}};var X=new Set(b),J=n=>X.has(n),I=class{constructor(r="testnet",a="",e=new client.SuiClient({url:client.getFullnodeUrl(r)}),t){this.suiClient=e;this.dbConfig=t??new deepbookV3.DeepBookConfig({env:r,address:a,coins:c,pools:f,marginPools:{SUI:{address:d.SUI.address,type:d.SUI.coinType},DBUSDC:{address:d.DBUSDC.address,type:d.DBUSDC.coinType}}}),this.marginPoolContract=new deepbookV3.MarginPoolContract(this.dbConfig);}marginPoolContract;dbConfig;get env(){return this.dbConfig.env}#r(r,a,e,t){if(J(a)){let i=this.marginPoolContract[a];if(t==null)throw new Error(`supplierCap is required for '${a}'.`);r.add(i(e,t));}else {let i=this.marginPoolContract[a];r.add(i(e));}}#e(r,a){let e=r.results;return e?a.reduce((t,i,o)=>{let s=e[o]?.returnValues?.[0]?.[0];if(!s)return t;let l=bcs.bcs[B[i]];return t[i]=l.parse(new Uint8Array(s)),t},{}):{}}#t(r,a){let e=this.dbConfig.getCoin(a),t={supplyCap:0,maxUtilizationRate:0,protocolSpread:0,minBorrow:0,interestRate:0,totalSupply:0,supplyShares:0,totalBorrow:0,borrowShares:0,lastUpdateTimestamp:0,userSupplyShares:0,userSupplyAmount:0,decimals:0,midKink:0,highKink:0,baseBorrowApr:0,midBorrowApr:0,highBorrowApr:0,maxBorrowApr:0,borrowApr:0,...e};if(!e)return t;let i=new Set(["interestRate","maxUtilizationRate","protocolSpread"]);for(let[o,s]of Object.entries(r))o==="lastUpdateTimestamp"?t[o]=Number(s):i.has(o)?t[o]=new bignumber_js.BigNumber(s).dividedBy(deepbookV3.FLOAT_SCALAR).toNumber():t[o]=new bignumber_js.BigNumber(s).dividedBy(e.scalar).toNumber();return t}#a(r,a){let e=BigInt(a.base_rate),t=BigInt(a.base_slope),i=BigInt(a.excess_slope),o=BigInt(a.optimal_utilization),s=r<0n?0n:r>BigInt(deepbookV3.FLOAT_SCALAR)?BigInt(deepbookV3.FLOAT_SCALAR):BigInt(r);return s<=o?e+t*s/o:e+t+i*(s-o)/(BigInt(deepbookV3.FLOAT_SCALAR)-o)}#o(r,a,e){let t=BigInt(r.base_rate),i=BigInt(r.base_slope),o=BigInt(r.excess_slope),s=BigInt(r.optimal_utilization),l=BigInt(a.max_utilization_rate),p=s,m=l,C=t,E=t+i,T=t+i+o*(l-s)/(1000000000n-s),A=t+i+o,U=this.#a(BigInt(bignumber_js.BigNumber(e.total_borrow).dividedBy(e.total_supply).shiftedBy(9).decimalPlaces(0).toString()),r),u=M=>bignumber_js.BigNumber(M).dividedBy(deepbookV3.FLOAT_SCALAR).toNumber();return {raw:{midKink:p,highKink:m,baseBorrowApr:C,midBorrowApr:E,highBorrowApr:T,maxBorrowApr:A,borrowApr:U},normalized:{midKink:u(p),highKink:u(m),baseBorrowApr:u(C),midBorrowApr:u(E),highBorrowApr:u(T),maxBorrowApr:u(A),borrowApr:u(U)}}}async#i(r){let{address:a}=this.dbConfig.getMarginPool(r),t=((await this.suiClient.getObject({id:a,options:{showContent:true}})).data?.content).fields,i=t.config.fields,o=i.interest_config.fields,s=i.margin_pool_config.fields,l=t.state.fields,{normalized:p}=this.#o(o,s,l);return p}async getPoolParameters(r,a,e=new transactions.Transaction,t=true){if(P.forEach(p=>this.#r(e,p,r)),a&&b.forEach(p=>this.#r(e,p,r,a)),!t)return e;let i=[...P,...b],o=await this.suiClient.devInspectTransactionBlock({transactionBlock:e,sender:this.dbConfig.address}),s=await this.#i(r);return {...this.#t(this.#e(o,i),r),...s}}};exports.DeepBookMarginPool=I;exports.DeepBookMarginToolkit=w;
+'use strict';var client=require('@mysten/sui/client'),ed25519=require('@mysten/sui/keypairs/ed25519'),transactions=require('@mysten/sui/transactions'),deepbookV3=require('@mysten/deepbook-v3'),cryptography=require('@mysten/sui/cryptography'),bcs$1=require('@mysten/bcs'),bcs=require('@mysten/sui/bcs'),bignumber_js=require('bignumber.js');var K=a=>/^0x[0-9a-fA-F]+$|^[0-9a-fA-F]+$/.test(a),B=a=>/^[a-zA-Z0-9+/]+={0,2}$/g.test(a),S=a=>{if(K(a))return bcs$1.fromHex(a);if(B(a))return bcs$1.fromBase64(a);throw new Error("The string is not a valid hex or base64 string.")},f=a=>{if(a.length===cryptography.LEGACY_PRIVATE_KEY_SIZE)return a.slice(0,cryptography.PRIVATE_KEY_SIZE);if(a.length===cryptography.PRIVATE_KEY_SIZE+1&&a[0]===0)return a.slice(1);if(a.length===cryptography.PRIVATE_KEY_SIZE)return a;throw new Error("invalid secret key")};var C=class{suiClient;keypair;address;marginPoolContract;supplierCapId;dbConfig;supplierCapPackageId;constructor({network:r,fullnodeUrl:e,supplierCapId:t,privateKey:i,supplierCapPackageId:o,dbConfig:n}){let s=e??client.getFullnodeUrl(r);this.suiClient=new client.SuiClient({url:s}),this.keypair=this.#r(i),this.address=this.keypair.getPublicKey().toSuiAddress(),this.supplierCapId=t,this.dbConfig=n??new deepbookV3.DeepBookConfig({env:r,address:this.address}),this.marginPoolContract=new deepbookV3.MarginPoolContract(this.dbConfig),this.supplierCapPackageId=o??this.dbConfig.MARGIN_PACKAGE_ID;}#r(r){if(r.startsWith(cryptography.SUI_PRIVATE_KEY_PREFIX)){let{secretKey:e}=cryptography.decodeSuiPrivateKey(r);return ed25519.Ed25519Keypair.fromSecretKey(f(e))}return ed25519.Ed25519Keypair.fromSecretKey(f(S(r)))}async#t(){let r=`${this.dbConfig.MARGIN_PACKAGE_ID}::margin_pool::SupplierCap`;return (await this.suiClient.getOwnedObjects({owner:this.address,filter:{StructType:r},options:{showType:true}})).data?.[0]?.data?.objectId}async initialize(){if(this.supplierCapId)return this.supplierCapId;let r=await this.#t();if(r)return this.supplierCapId=r,r;let e=await this.createSupplierCap();if(!e)throw new Error("Failed to create Supplier Cap");return this.supplierCapId=e,e}async createSupplierCap(){try{let r=new transactions.Transaction;r.setSender(this.address);let e=r.moveCall({target:`${this.supplierCapPackageId}::margin_pool::mint_supplier_cap`,arguments:[r.object(this.dbConfig.MARGIN_REGISTRY_ID),r.object.clock()]});r.transferObjects([e],r.pure.address(this.address));let t=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:r,options:{showEffects:!0,showObjectChanges:!0}});if(t.errors&&t.errors.length>0)throw new Error(`Transaction failed with errors: ${t.errors.map(i=>i.toString()).join(", ")}`);if(t.objectChanges){for(let i of t.objectChanges)if(i.type==="created"&&i.objectType.includes("SupplierCap"))return i.objectId}return null}catch(r){throw new Error(`Failed to create Supplier Cap: ${r.message||r}`)}}async createSupplyReferral(r){try{let e=new transactions.Transaction;e.setSender(this.address);let t=this.dbConfig.getMarginPool(r);if(!t)throw new Error(`Margin pool configuration not found for coin: ${r}`);e.moveCall({target:`${this.dbConfig.MARGIN_PACKAGE_ID}::margin_pool::mint_supply_referral`,arguments:[e.object(t.address),e.object(this.dbConfig.MARGIN_REGISTRY_ID),e.object.clock()],typeArguments:[t.type]});let i=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:e,options:{showEffects:!0,showObjectChanges:!0}});if(i.errors&&i.errors.length>0)throw new Error(`Transaction failed with errors: ${i.errors.map(o=>o.toString()).join(", ")}`);if(i.objectChanges){for(let o of i.objectChanges)if(o.type==="created"&&o.objectType.includes("SupplyReferral"))return o.objectId}return null}catch(e){throw new Error(`Failed to create Supply Referral: ${e.message||e}`)}}async supplyToMarginPool(r,e,t){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let i=new transactions.Transaction;i.setSender(this.address);let o=i.object(this.supplierCapId);i.add(this.marginPoolContract.supplyToMarginPool(r,o,e,t));let{errors:n}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:i,options:{showEffects:!0,showObjectChanges:!0}});if(n&&n.length>0)throw new Error(`Transaction failed with errors: ${n.map(s=>s.toString()).join(", ")}`);return !0}catch(i){throw new Error(`Failed to supply to margin pool: ${i.message||i}`)}}async withdrawFromMarginPool(r,e){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let t=new transactions.Transaction,i=t.object(this.supplierCapId),n=this.marginPoolContract.withdrawFromMarginPool(r,i,e)(t);t.transferObjects([n],this.address);let{errors:s}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:t,options:{showEffects:!0,showObjectChanges:!0}});if(s&&s.length>0)throw new Error(`Transaction failed with errors: ${s.map(l=>l.toString()).join(", ")}`);return !0}catch(t){throw new Error(`Failed to withdraw from margin pool: ${t.message||t}`)}}async withdrawReferralFees(r,e){try{let t=new transactions.Transaction;t.add(this.marginPoolContract.withdrawReferralFees(r,e));let{errors:i}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:t,options:{showEffects:!0,showObjectChanges:!0,showBalanceChanges:!0}});if(i&&i.length>0)throw new Error(`Transaction failed with errors: ${i.map(o=>o.toString()).join(", ")}`);return !0}catch(t){throw new Error(`Failed to withdraw referral fees: ${t.message||t}`)}}async getBalance(r){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let e=new transactions.Transaction;e.add(this.marginPoolContract.userSupplyAmount(r,this.supplierCapId));let t=await this.suiClient.devInspectTransactionBlock({sender:this.address,transactionBlock:e}),i=0;if(t&&t.results&&t.results[0]&&t.results[0].returnValues){let p=t.results[0].returnValues[0];if(p&&p[0]){let g=Buffer.from(p[0]).readBigUInt64LE(),R=this.dbConfig.getCoin(r).scalar;i=Number(g)/R;}}let o=this.dbConfig.getCoin(r).type,n=await this.suiClient.getBalance({owner:this.address,coinType:o}),s=this.dbConfig.getCoin(r).scalar,l=Number(n.totalBalance)/s;return {userSupplyAmount:i,walletBalance:l}}catch(e){throw new Error(`Failed to get balance: ${e.message||e}`)}}getSupplierCapId(){return this.supplierCapId}getAddress(){return this.address}};var P=["supplyCap","maxUtilizationRate","protocolSpread","minBorrow","interestRate","totalSupply","supplyShares","totalBorrow","borrowShares","lastUpdateTimestamp"],m=["userSupplyShares","userSupplyAmount"],A={supplyCap:"U64",maxUtilizationRate:"U64",protocolSpread:"U64",minBorrow:"U64",interestRate:"U64",totalSupply:"U64",supplyShares:"U64",totalBorrow:"U64",borrowShares:"U64",lastUpdateTimestamp:"U64",userSupplyShares:"U64",userSupplyAmount:"U64"};var d=(a,r)=>a*r/BigInt(deepbookV3.FLOAT_SCALAR),c=a=>Number(a)/deepbookV3.FLOAT_SCALAR;var W=new Set(m),Y=a=>W.has(a),b=class{marginPoolContract;dbConfig;suiClient;constructor({env:r="mainnet",address:e="",suiClient:t=new client.SuiClient({url:client.getFullnodeUrl(r)}),dbConfig:i=new deepbookV3.DeepBookConfig({env:r,address:e})}={}){if(this.dbConfig=i,this.suiClient=t,this.marginPoolContract=new deepbookV3.MarginPoolContract(this.dbConfig),r!==this.env)throw new Error(`Mismatch between provided env (${r}) and dbConfig env (${this.env}).`)}get env(){return this.dbConfig.env}#r(r,e,t,i){if(Y(e)){let o=this.marginPoolContract[e];if(i==null)throw new Error(`supplierCap is required for '${e}'.`);r.add(o(t,i));}else {let o=this.marginPoolContract[e];r.add(o(t));}}#t(r,e){let t=r.results;return t?e.reduce((i,o,n)=>{let s=t[n]?.returnValues?.[0]?.[0];if(!s)return i;let l=bcs.bcs[A[o]];return i[o]=l.parse(new Uint8Array(s)),i},{}):{}}#i(r,e){let t=this.dbConfig.getCoin(e),i={supplyCap:0,maxUtilizationRate:0,protocolSpread:0,minBorrow:0,interestRate:0,totalSupply:0,supplyShares:0,totalBorrow:0,borrowShares:0,lastUpdateTimestamp:0,userSupplyShares:0,userSupplyAmount:0,decimals:this.dbConfig.getCoin(e).scalar.toString().length-1,highKink:0,baseBorrowApr:0,borrowAprOnHighKink:0,maxBorrowApr:0,supplyApr:0,utilizationRate:0,...t};if(!t)return i;let o=new Set(["interestRate","maxUtilizationRate","protocolSpread"]);for(let[n,s]of Object.entries(r))n==="lastUpdateTimestamp"?i[n]=Number(s):o.has(n)?i[n]=new bignumber_js.BigNumber(s).dividedBy(deepbookV3.FLOAT_SCALAR).toNumber():i[n]=new bignumber_js.BigNumber(s).dividedBy(t.scalar).toNumber();return i}#e(r,e){let t=BigInt(e.base_rate),i=BigInt(e.base_slope),o=BigInt(e.excess_slope),n=BigInt(e.optimal_utilization);return r<n?t+d(r,i):t+d(n,i)+d(r-n,o)}#o(r,e,t,i){let o=BigInt(r.optimal_utilization),n=BigInt(e.max_utilization_rate),s=this.#e(o,r),l=this.#e(n,r),p=BigInt(bignumber_js.BigNumber(t.total_borrow).dividedBy(t.total_supply).shiftedBy(9).decimalPlaces(0).toString()),g=d(d(BigInt(i),p),BigInt(deepbookV3.FLOAT_SCALAR)-BigInt(e.protocol_spread));return {raw:{baseBorrowApr:r.base_rate,highKink:o,borrowAprOnHighKink:s,maxBorrowApr:l,supplyApr:g,utilizationRate:p},normalized:{baseBorrowApr:c(BigInt(r.base_rate)),highKink:c(o),borrowAprOnHighKink:c(s),maxBorrowApr:c(l),supplyApr:c(g),utilizationRate:c(p)}}}async#n(r,e){let{address:t}=this.dbConfig.getMarginPool(r),o=((await this.suiClient.getObject({id:t,options:{showContent:true}})).data?.content).fields,n=o.config.fields,s=n.interest_config.fields,l=n.margin_pool_config.fields,p=o.state.fields,{normalized:g}=this.#o(s,l,p,e);return g}async getPoolParameters(r,e,t=new transactions.Transaction,i=true){if(P.forEach(p=>this.#r(t,p,r)),e&&m.forEach(p=>this.#r(t,p,r,e)),!i)return t;let o=[...P,...m],n=await this.suiClient.devInspectTransactionBlock({transactionBlock:t,sender:this.dbConfig.address}),s=this.#i(this.#t(n,o),r),l=await this.#n(r,s.interestRate*deepbookV3.FLOAT_SCALAR);return {...s,...l}}};exports.DeepBookMarginPool=b;exports.DeepBookMarginToolkit=C;

package/dist/index.mjs

@@ -1 +1 @@
-import {getFullnodeUrl,SuiClient}from'@mysten/sui/client';import {Ed25519Keypair}from'@mysten/sui/keypairs/ed25519';import {Transaction}from'@mysten/sui/transactions';import {DeepBookConfig,MarginPoolContract,FLOAT_SCALAR}from'@mysten/deepbook-v3';import {SUI_PRIVATE_KEY_PREFIX,decodeSuiPrivateKey,LEGACY_PRIVATE_KEY_SIZE,PRIVATE_KEY_SIZE}from'@mysten/sui/cryptography';import {fromHex,fromBase64}from'@mysten/bcs';import {bcs}from'@mysten/sui/bcs';import {BigNumber}from'bignumber.js';var D={MARGIN_INITIAL_PACKAGE_ID:"0x7f2d8f15343f210e813595a8798d6197d152061d0a35be938372f4b1cd66f209"},c={DEEP:{address:"0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8",type:"0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP",scalar:1e6,decimals:6},SUI:{address:"0x0000000000000000000000000000000000000000000000000000000000000002",type:"0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",scalar:1e9,decimals:9},DBUSDC:{address:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7",type:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7::DBUSDC::DBUSDC",scalar:1e6,decimals:6},DBUSDT:{address:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7",type:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7::DBUSDT::DBUSDT",scalar:1e6,decimals:6},WAL:{address:"0x9ef7676a9f81937a52ae4b2af8d511a28a0b080477c0c2db40b0ab8882240d76",type:"0x9ef7676a9f81937a52ae4b2af8d511a28a0b080477c0c2db40b0ab8882240d76::wal::WAL",scalar:1e9,decimals:9}},f={DEEP_SUI:{address:"0x48c95963e9eac37a316b7ae04a0deb761bcdcc2b67912374d6036e7f0e9bae9f",baseCoin:"DEEP",quoteCoin:"SUI",lotSize:1e6,tickSize:1e6},SUI_DBUSDC:{address:"0x1c19362ca52b8ffd7a33cee805a67d40f31e6ba303753fd3a4cfdfacea7163a5",baseCoin:"SUI",quoteCoin:"DBUSDC",lotSize:1e6,tickSize:1e3},DEEP_DBUSDC:{address:"0xe86b991f8632217505fd859445f9803967ac84a9d4a1219065bf191fcb74b622",baseCoin:"DEEP",quoteCoin:"DBUSDC",lotSize:1e6,tickSize:1e3},DBUSDT_DBUSDC:{address:"0x83970bb02e3636efdff8c141ab06af5e3c9a22e2f74d7f02a9c3430d0d10c1ca",baseCoin:"DBUSDT",quoteCoin:"DBUSDC",lotSize:1e6,tickSize:1e3},WAL_DBUSDC:{address:"0xeb524b6aea0ec4b494878582e0b78924208339d360b62aec4a8ecd4031520dbb",baseCoin:"WAL",quoteCoin:"DBUSDC",lotSize:1e6,tickSize:1e3},WAL_SUI:{address:"0x8c1c1b186c4fddab1ebd53e0895a36c1d1b3b9a77cd34e607bef49a38af0150a",baseCoin:"WAL",quoteCoin:"SUI",lotSize:1e6,tickSize:1e6}},d={SUI:{address:"0xe620d6a5390e57e88baff18af89383130d4210eb496a024edcd62f270a655af7",coinType:"0x2::sui::SUI"},DBUSDC:{address:"0xfd0dc290a120ad6c534507614d4dc0b2e78baab649c35bfacbaec2ce18140b69",coinType:"0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7::DBUSDC::DBUSDC"}};var P=["supplyCap","maxUtilizationRate","protocolSpread","minBorrow","interestRate","totalSupply","supplyShares","totalBorrow","borrowShares","lastUpdateTimestamp"],b=["userSupplyShares","userSupplyAmount"],B={supplyCap:"U64",maxUtilizationRate:"U64",protocolSpread:"U64",minBorrow:"U64",interestRate:"U64",totalSupply:"U64",supplyShares:"U64",totalBorrow:"U64",borrowShares:"U64",lastUpdateTimestamp:"U64",userSupplyShares:"U64",userSupplyAmount:"U64"};var k=n=>/^0x[0-9a-fA-F]+$|^[0-9a-fA-F]+$/.test(n),L=n=>/^[a-zA-Z0-9+/]+={0,2}$/g.test(n),x=n=>{if(k(n))return fromHex(n);if(L(n))return fromBase64(n);throw new Error("The string is not a valid hex or base64 string.")},_=n=>{if(n.length===LEGACY_PRIVATE_KEY_SIZE)return n.slice(0,PRIVATE_KEY_SIZE);if(n.length===PRIVATE_KEY_SIZE+1&&n[0]===0)return n.slice(1);if(n.length===PRIVATE_KEY_SIZE)return n;throw new Error("invalid secret key")};var w=class{suiClient;keypair;address;marginPoolContract;supplierCapId;constructor(r){let a=r.fullnodeUrl??getFullnodeUrl(r.network);this.suiClient=new SuiClient({url:a}),this.keypair=this.#r(r.privateKey),this.address=this.keypair.getPublicKey().toSuiAddress(),this.supplierCapId=r.supplierCapId;let e={DEEP:{address:c.DEEP.address,type:c.DEEP.type,scalar:c.DEEP.scalar},SUI:{address:c.SUI.address,type:c.SUI.type,scalar:c.SUI.scalar},DBUSDC:{address:c.DBUSDC.address,type:c.DBUSDC.type,scalar:c.DBUSDC.scalar}},t={SUI_DBUSDC:{address:f.SUI_DBUSDC.address,baseCoin:f.SUI_DBUSDC.baseCoin,quoteCoin:f.SUI_DBUSDC.quoteCoin}},i={SUI:{address:d.SUI.address,type:d.SUI.coinType},DBUSDC:{address:d.DBUSDC.address,type:d.DBUSDC.coinType}},o=new DeepBookConfig({address:this.address,env:r.network,coins:e,pools:t,marginPools:i});this.marginPoolContract=new MarginPoolContract(o);}#r(r){if(r.startsWith(SUI_PRIVATE_KEY_PREFIX)){let{secretKey:a}=decodeSuiPrivateKey(r);return Ed25519Keypair.fromSecretKey(_(a))}return Ed25519Keypair.fromSecretKey(_(x(r)))}async#e(){let r=`${D.MARGIN_INITIAL_PACKAGE_ID}::margin_pool::SupplierCap`;return (await this.suiClient.getOwnedObjects({owner:this.address,filter:{StructType:r},options:{showType:true}})).data?.[0]?.data?.objectId}async initialize(){if(this.supplierCapId)return this.supplierCapId;let r=await this.#e();if(r)return this.supplierCapId=r,r;let a=await this.createSupplierCap();if(!a)throw new Error("Failed to create Supplier Cap");return this.supplierCapId=a,a}async createSupplierCap(){try{let r=new Transaction,a=this.marginPoolContract.mintSupplierCap()(r);r.transferObjects([a],this.address);let e=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:r,options:{showEffects:!0,showObjectChanges:!0}});if(e.errors&&e.errors.length>0)throw new Error(`Transaction failed with errors: ${e.errors.map(t=>t.toString()).join(", ")}`);if(e.objectChanges){for(let t of e.objectChanges)if(t.type==="created"&&t.objectType.includes("SupplierCap"))return t.objectId}return null}catch(r){throw new Error(`Failed to create Supplier Cap: ${r.message||r}`)}}async createSupplyReferral(r){try{let a=new Transaction;this.marginPoolContract.mintSupplyReferral(r)(a);let e=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:a,options:{showEffects:!0,showObjectChanges:!0}});if(e.errors&&e.errors.length>0)throw new Error(`Transaction failed with errors: ${e.errors.map(t=>t.toString()).join(", ")}`);if(e.objectChanges){for(let t of e.objectChanges)if(t.type==="created"&&t.objectType.includes("SupplyReferral"))return t.objectId}return null}catch(a){throw new Error(`Failed to create Supply Referral: ${a.message||a}`)}}async supplyToMarginPool(r,a,e){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let t=new Transaction;t.setSender(this.address);let i=t.object(this.supplierCapId);t.add(this.marginPoolContract.supplyToMarginPool(r,i,a,e));let{errors:o}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:t,options:{showEffects:!0,showObjectChanges:!0}});if(o&&o.length>0)throw new Error(`Transaction failed with errors: ${o.map(s=>s.toString()).join(", ")}`);return !0}catch(t){throw new Error(`Failed to supply to margin pool: ${t.message||t}`)}}async withdrawFromMarginPool(r,a){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let e=new Transaction,t=e.object(this.supplierCapId),o=this.marginPoolContract.withdrawFromMarginPool(r,t,a)(e);e.transferObjects([o],this.address);let{errors:s}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:e,options:{showEffects:!0,showObjectChanges:!0}});if(s&&s.length>0)throw new Error(`Transaction failed with errors: ${s.map(l=>l.toString()).join(", ")}`);return !0}catch(e){throw new Error(`Failed to withdraw from margin pool: ${e.message||e}`)}}async withdrawReferralFees(r,a){try{let e=new Transaction;e.add(this.marginPoolContract.withdrawReferralFees(r,a));let{errors:t}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:e,options:{showEffects:!0,showObjectChanges:!0,showBalanceChanges:!0}});if(t&&t.length>0)throw new Error(`Transaction failed with errors: ${t.map(i=>i.toString()).join(", ")}`);return !0}catch(e){throw new Error(`Failed to withdraw referral fees: ${e.message||e}`)}}async getBalance(r){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let a=new Transaction;a.add(this.marginPoolContract.userSupplyAmount(r,this.supplierCapId));let e=await this.suiClient.devInspectTransactionBlock({sender:this.address,transactionBlock:a}),t=0;if(e&&e.results&&e.results[0]&&e.results[0].returnValues){let p=e.results[0].returnValues[0];if(p&&p[0]){let m=Buffer.from(p[0]).readBigUInt64LE(),C=r==="SUI"?c.SUI.scalar:c.DBUSDC.scalar;t=Number(m)/C;}}let i=r==="SUI"?c.SUI.type:c.DBUSDC.type,o=await this.suiClient.getBalance({owner:this.address,coinType:i}),s=r==="SUI"?c.SUI.scalar:c.DBUSDC.scalar,l=Number(o.totalBalance)/s;return {userSupplyAmount:t,walletBalance:l}}catch(a){throw new Error(`Failed to get balance: ${a.message||a}`)}}getSupplierCapId(){return this.supplierCapId}getAddress(){return this.address}};var X=new Set(b),J=n=>X.has(n),I=class{constructor(r="testnet",a="",e=new SuiClient({url:getFullnodeUrl(r)}),t){this.suiClient=e;this.dbConfig=t??new DeepBookConfig({env:r,address:a,coins:c,pools:f,marginPools:{SUI:{address:d.SUI.address,type:d.SUI.coinType},DBUSDC:{address:d.DBUSDC.address,type:d.DBUSDC.coinType}}}),this.marginPoolContract=new MarginPoolContract(this.dbConfig);}marginPoolContract;dbConfig;get env(){return this.dbConfig.env}#r(r,a,e,t){if(J(a)){let i=this.marginPoolContract[a];if(t==null)throw new Error(`supplierCap is required for '${a}'.`);r.add(i(e,t));}else {let i=this.marginPoolContract[a];r.add(i(e));}}#e(r,a){let e=r.results;return e?a.reduce((t,i,o)=>{let s=e[o]?.returnValues?.[0]?.[0];if(!s)return t;let l=bcs[B[i]];return t[i]=l.parse(new Uint8Array(s)),t},{}):{}}#t(r,a){let e=this.dbConfig.getCoin(a),t={supplyCap:0,maxUtilizationRate:0,protocolSpread:0,minBorrow:0,interestRate:0,totalSupply:0,supplyShares:0,totalBorrow:0,borrowShares:0,lastUpdateTimestamp:0,userSupplyShares:0,userSupplyAmount:0,decimals:0,midKink:0,highKink:0,baseBorrowApr:0,midBorrowApr:0,highBorrowApr:0,maxBorrowApr:0,borrowApr:0,...e};if(!e)return t;let i=new Set(["interestRate","maxUtilizationRate","protocolSpread"]);for(let[o,s]of Object.entries(r))o==="lastUpdateTimestamp"?t[o]=Number(s):i.has(o)?t[o]=new BigNumber(s).dividedBy(FLOAT_SCALAR).toNumber():t[o]=new BigNumber(s).dividedBy(e.scalar).toNumber();return t}#a(r,a){let e=BigInt(a.base_rate),t=BigInt(a.base_slope),i=BigInt(a.excess_slope),o=BigInt(a.optimal_utilization),s=r<0n?0n:r>BigInt(FLOAT_SCALAR)?BigInt(FLOAT_SCALAR):BigInt(r);return s<=o?e+t*s/o:e+t+i*(s-o)/(BigInt(FLOAT_SCALAR)-o)}#o(r,a,e){let t=BigInt(r.base_rate),i=BigInt(r.base_slope),o=BigInt(r.excess_slope),s=BigInt(r.optimal_utilization),l=BigInt(a.max_utilization_rate),p=s,m=l,C=t,E=t+i,T=t+i+o*(l-s)/(1000000000n-s),A=t+i+o,U=this.#a(BigInt(BigNumber(e.total_borrow).dividedBy(e.total_supply).shiftedBy(9).decimalPlaces(0).toString()),r),u=M=>BigNumber(M).dividedBy(FLOAT_SCALAR).toNumber();return {raw:{midKink:p,highKink:m,baseBorrowApr:C,midBorrowApr:E,highBorrowApr:T,maxBorrowApr:A,borrowApr:U},normalized:{midKink:u(p),highKink:u(m),baseBorrowApr:u(C),midBorrowApr:u(E),highBorrowApr:u(T),maxBorrowApr:u(A),borrowApr:u(U)}}}async#i(r){let{address:a}=this.dbConfig.getMarginPool(r),t=((await this.suiClient.getObject({id:a,options:{showContent:true}})).data?.content).fields,i=t.config.fields,o=i.interest_config.fields,s=i.margin_pool_config.fields,l=t.state.fields,{normalized:p}=this.#o(o,s,l);return p}async getPoolParameters(r,a,e=new Transaction,t=true){if(P.forEach(p=>this.#r(e,p,r)),a&&b.forEach(p=>this.#r(e,p,r,a)),!t)return e;let i=[...P,...b],o=await this.suiClient.devInspectTransactionBlock({transactionBlock:e,sender:this.dbConfig.address}),s=await this.#i(r);return {...this.#t(this.#e(o,i),r),...s}}};export{I as DeepBookMarginPool,w as DeepBookMarginToolkit};
+import {getFullnodeUrl,SuiClient}from'@mysten/sui/client';import {Ed25519Keypair}from'@mysten/sui/keypairs/ed25519';import {Transaction}from'@mysten/sui/transactions';import {DeepBookConfig,MarginPoolContract,FLOAT_SCALAR}from'@mysten/deepbook-v3';import {SUI_PRIVATE_KEY_PREFIX,decodeSuiPrivateKey,LEGACY_PRIVATE_KEY_SIZE,PRIVATE_KEY_SIZE}from'@mysten/sui/cryptography';import {fromHex,fromBase64}from'@mysten/bcs';import {bcs}from'@mysten/sui/bcs';import {BigNumber}from'bignumber.js';var K=a=>/^0x[0-9a-fA-F]+$|^[0-9a-fA-F]+$/.test(a),B=a=>/^[a-zA-Z0-9+/]+={0,2}$/g.test(a),S=a=>{if(K(a))return fromHex(a);if(B(a))return fromBase64(a);throw new Error("The string is not a valid hex or base64 string.")},f=a=>{if(a.length===LEGACY_PRIVATE_KEY_SIZE)return a.slice(0,PRIVATE_KEY_SIZE);if(a.length===PRIVATE_KEY_SIZE+1&&a[0]===0)return a.slice(1);if(a.length===PRIVATE_KEY_SIZE)return a;throw new Error("invalid secret key")};var C=class{suiClient;keypair;address;marginPoolContract;supplierCapId;dbConfig;supplierCapPackageId;constructor({network:r,fullnodeUrl:e,supplierCapId:t,privateKey:i,supplierCapPackageId:o,dbConfig:n}){let s=e??getFullnodeUrl(r);this.suiClient=new SuiClient({url:s}),this.keypair=this.#r(i),this.address=this.keypair.getPublicKey().toSuiAddress(),this.supplierCapId=t,this.dbConfig=n??new DeepBookConfig({env:r,address:this.address}),this.marginPoolContract=new MarginPoolContract(this.dbConfig),this.supplierCapPackageId=o??this.dbConfig.MARGIN_PACKAGE_ID;}#r(r){if(r.startsWith(SUI_PRIVATE_KEY_PREFIX)){let{secretKey:e}=decodeSuiPrivateKey(r);return Ed25519Keypair.fromSecretKey(f(e))}return Ed25519Keypair.fromSecretKey(f(S(r)))}async#t(){let r=`${this.dbConfig.MARGIN_PACKAGE_ID}::margin_pool::SupplierCap`;return (await this.suiClient.getOwnedObjects({owner:this.address,filter:{StructType:r},options:{showType:true}})).data?.[0]?.data?.objectId}async initialize(){if(this.supplierCapId)return this.supplierCapId;let r=await this.#t();if(r)return this.supplierCapId=r,r;let e=await this.createSupplierCap();if(!e)throw new Error("Failed to create Supplier Cap");return this.supplierCapId=e,e}async createSupplierCap(){try{let r=new Transaction;r.setSender(this.address);let e=r.moveCall({target:`${this.supplierCapPackageId}::margin_pool::mint_supplier_cap`,arguments:[r.object(this.dbConfig.MARGIN_REGISTRY_ID),r.object.clock()]});r.transferObjects([e],r.pure.address(this.address));let t=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:r,options:{showEffects:!0,showObjectChanges:!0}});if(t.errors&&t.errors.length>0)throw new Error(`Transaction failed with errors: ${t.errors.map(i=>i.toString()).join(", ")}`);if(t.objectChanges){for(let i of t.objectChanges)if(i.type==="created"&&i.objectType.includes("SupplierCap"))return i.objectId}return null}catch(r){throw new Error(`Failed to create Supplier Cap: ${r.message||r}`)}}async createSupplyReferral(r){try{let e=new Transaction;e.setSender(this.address);let t=this.dbConfig.getMarginPool(r);if(!t)throw new Error(`Margin pool configuration not found for coin: ${r}`);e.moveCall({target:`${this.dbConfig.MARGIN_PACKAGE_ID}::margin_pool::mint_supply_referral`,arguments:[e.object(t.address),e.object(this.dbConfig.MARGIN_REGISTRY_ID),e.object.clock()],typeArguments:[t.type]});let i=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:e,options:{showEffects:!0,showObjectChanges:!0}});if(i.errors&&i.errors.length>0)throw new Error(`Transaction failed with errors: ${i.errors.map(o=>o.toString()).join(", ")}`);if(i.objectChanges){for(let o of i.objectChanges)if(o.type==="created"&&o.objectType.includes("SupplyReferral"))return o.objectId}return null}catch(e){throw new Error(`Failed to create Supply Referral: ${e.message||e}`)}}async supplyToMarginPool(r,e,t){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let i=new Transaction;i.setSender(this.address);let o=i.object(this.supplierCapId);i.add(this.marginPoolContract.supplyToMarginPool(r,o,e,t));let{errors:n}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:i,options:{showEffects:!0,showObjectChanges:!0}});if(n&&n.length>0)throw new Error(`Transaction failed with errors: ${n.map(s=>s.toString()).join(", ")}`);return !0}catch(i){throw new Error(`Failed to supply to margin pool: ${i.message||i}`)}}async withdrawFromMarginPool(r,e){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let t=new Transaction,i=t.object(this.supplierCapId),n=this.marginPoolContract.withdrawFromMarginPool(r,i,e)(t);t.transferObjects([n],this.address);let{errors:s}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:t,options:{showEffects:!0,showObjectChanges:!0}});if(s&&s.length>0)throw new Error(`Transaction failed with errors: ${s.map(l=>l.toString()).join(", ")}`);return !0}catch(t){throw new Error(`Failed to withdraw from margin pool: ${t.message||t}`)}}async withdrawReferralFees(r,e){try{let t=new Transaction;t.add(this.marginPoolContract.withdrawReferralFees(r,e));let{errors:i}=await this.suiClient.signAndExecuteTransaction({signer:this.keypair,transaction:t,options:{showEffects:!0,showObjectChanges:!0,showBalanceChanges:!0}});if(i&&i.length>0)throw new Error(`Transaction failed with errors: ${i.map(o=>o.toString()).join(", ")}`);return !0}catch(t){throw new Error(`Failed to withdraw referral fees: ${t.message||t}`)}}async getBalance(r){try{if(!this.supplierCapId)throw new Error("Supplier Cap not initialized. Call initialize() first.");let e=new Transaction;e.add(this.marginPoolContract.userSupplyAmount(r,this.supplierCapId));let t=await this.suiClient.devInspectTransactionBlock({sender:this.address,transactionBlock:e}),i=0;if(t&&t.results&&t.results[0]&&t.results[0].returnValues){let p=t.results[0].returnValues[0];if(p&&p[0]){let g=Buffer.from(p[0]).readBigUInt64LE(),R=this.dbConfig.getCoin(r).scalar;i=Number(g)/R;}}let o=this.dbConfig.getCoin(r).type,n=await this.suiClient.getBalance({owner:this.address,coinType:o}),s=this.dbConfig.getCoin(r).scalar,l=Number(n.totalBalance)/s;return {userSupplyAmount:i,walletBalance:l}}catch(e){throw new Error(`Failed to get balance: ${e.message||e}`)}}getSupplierCapId(){return this.supplierCapId}getAddress(){return this.address}};var P=["supplyCap","maxUtilizationRate","protocolSpread","minBorrow","interestRate","totalSupply","supplyShares","totalBorrow","borrowShares","lastUpdateTimestamp"],m=["userSupplyShares","userSupplyAmount"],A={supplyCap:"U64",maxUtilizationRate:"U64",protocolSpread:"U64",minBorrow:"U64",interestRate:"U64",totalSupply:"U64",supplyShares:"U64",totalBorrow:"U64",borrowShares:"U64",lastUpdateTimestamp:"U64",userSupplyShares:"U64",userSupplyAmount:"U64"};var d=(a,r)=>a*r/BigInt(FLOAT_SCALAR),c=a=>Number(a)/FLOAT_SCALAR;var W=new Set(m),Y=a=>W.has(a),b=class{marginPoolContract;dbConfig;suiClient;constructor({env:r="mainnet",address:e="",suiClient:t=new SuiClient({url:getFullnodeUrl(r)}),dbConfig:i=new DeepBookConfig({env:r,address:e})}={}){if(this.dbConfig=i,this.suiClient=t,this.marginPoolContract=new MarginPoolContract(this.dbConfig),r!==this.env)throw new Error(`Mismatch between provided env (${r}) and dbConfig env (${this.env}).`)}get env(){return this.dbConfig.env}#r(r,e,t,i){if(Y(e)){let o=this.marginPoolContract[e];if(i==null)throw new Error(`supplierCap is required for '${e}'.`);r.add(o(t,i));}else {let o=this.marginPoolContract[e];r.add(o(t));}}#t(r,e){let t=r.results;return t?e.reduce((i,o,n)=>{let s=t[n]?.returnValues?.[0]?.[0];if(!s)return i;let l=bcs[A[o]];return i[o]=l.parse(new Uint8Array(s)),i},{}):{}}#i(r,e){let t=this.dbConfig.getCoin(e),i={supplyCap:0,maxUtilizationRate:0,protocolSpread:0,minBorrow:0,interestRate:0,totalSupply:0,supplyShares:0,totalBorrow:0,borrowShares:0,lastUpdateTimestamp:0,userSupplyShares:0,userSupplyAmount:0,decimals:this.dbConfig.getCoin(e).scalar.toString().length-1,highKink:0,baseBorrowApr:0,borrowAprOnHighKink:0,maxBorrowApr:0,supplyApr:0,utilizationRate:0,...t};if(!t)return i;let o=new Set(["interestRate","maxUtilizationRate","protocolSpread"]);for(let[n,s]of Object.entries(r))n==="lastUpdateTimestamp"?i[n]=Number(s):o.has(n)?i[n]=new BigNumber(s).dividedBy(FLOAT_SCALAR).toNumber():i[n]=new BigNumber(s).dividedBy(t.scalar).toNumber();return i}#e(r,e){let t=BigInt(e.base_rate),i=BigInt(e.base_slope),o=BigInt(e.excess_slope),n=BigInt(e.optimal_utilization);return r<n?t+d(r,i):t+d(n,i)+d(r-n,o)}#o(r,e,t,i){let o=BigInt(r.optimal_utilization),n=BigInt(e.max_utilization_rate),s=this.#e(o,r),l=this.#e(n,r),p=BigInt(BigNumber(t.total_borrow).dividedBy(t.total_supply).shiftedBy(9).decimalPlaces(0).toString()),g=d(d(BigInt(i),p),BigInt(FLOAT_SCALAR)-BigInt(e.protocol_spread));return {raw:{baseBorrowApr:r.base_rate,highKink:o,borrowAprOnHighKink:s,maxBorrowApr:l,supplyApr:g,utilizationRate:p},normalized:{baseBorrowApr:c(BigInt(r.base_rate)),highKink:c(o),borrowAprOnHighKink:c(s),maxBorrowApr:c(l),supplyApr:c(g),utilizationRate:c(p)}}}async#n(r,e){let{address:t}=this.dbConfig.getMarginPool(r),o=((await this.suiClient.getObject({id:t,options:{showContent:true}})).data?.content).fields,n=o.config.fields,s=n.interest_config.fields,l=n.margin_pool_config.fields,p=o.state.fields,{normalized:g}=this.#o(s,l,p,e);return g}async getPoolParameters(r,e,t=new Transaction,i=true){if(P.forEach(p=>this.#r(t,p,r)),e&&m.forEach(p=>this.#r(t,p,r,e)),!i)return t;let o=[...P,...m],n=await this.suiClient.devInspectTransactionBlock({transactionBlock:t,sender:this.dbConfig.address}),s=this.#i(this.#t(n,o),r),l=await this.#n(r,s.interestRate*FLOAT_SCALAR);return {...s,...l}}};export{b as DeepBookMarginPool,C as DeepBookMarginToolkit};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scallop-io/scallop-deepbook-kit",
-  "version": "0.1.3",
+  "version": "0.1.5-rc.1",
   "description": "A toolkit for integrating Scallop with DeepBook functionality",
   "keywords": [
     "scallop",
@@ -54,8 +54,8 @@
   },
   "dependencies": {
     "@mysten/bcs": "^1.9.2",
-    "@mysten/deepbook-v3": "^0.21.0",
-    "@mysten/sui": "^1.45.0",
+    "@mysten/deepbook-v3": "^0.27.0",
+    "@mysten/sui": "^1.45.2",
     "bignumber.js": "^9.3.1",
     "dotenv": "^17.2.3"
   },

package/src/margin-pool-config.ts

@@ -0,0 +1,43 @@
+// ============================================================================
+// Margin Pool Contract Parameter Keys | Margin Pool 合約參數鍵
+// ============================================================================
+
+export const MARGIN_POOL_PARAM_KEYS = [
+  'supplyCap',
+  'maxUtilizationRate',
+  'protocolSpread',
+  'minBorrow',
+  'interestRate',
+  'totalSupply',
+  'supplyShares',
+  'totalBorrow',
+  'borrowShares',
+  'lastUpdateTimestamp',
+] as const;
+
+export const MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS = [
+  'userSupplyShares',
+  'userSupplyAmount',
+] as const;
+
+export const MARGIN_POOL_PARAM_KEY_STRUCT_MAP = {
+  supplyCap: 'U64',
+  maxUtilizationRate: 'U64',
+  protocolSpread: 'U64',
+  minBorrow: 'U64',
+  interestRate: 'U64',
+  totalSupply: 'U64',
+  supplyShares: 'U64',
+  totalBorrow: 'U64',
+  borrowShares: 'U64',
+  lastUpdateTimestamp: 'U64',
+  userSupplyShares: 'U64',
+  userSupplyAmount: 'U64',
+} as Record<
+  (typeof MARGIN_POOL_PARAM_KEYS)[number] | (typeof MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS)[number],
+  'U64'
+>;
+
+export type MarginPoolParamKey = (typeof MARGIN_POOL_PARAM_KEYS)[number];
+export type MarginPoolWithSupplierCapParamKey =
+  (typeof MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS)[number];

package/src/toolkit/DeepBookMarginPool.ts

@@ -1,26 +1,25 @@
 import { DeepBookConfig, FLOAT_SCALAR, MarginPoolContract } from '@mysten/deepbook-v3';
+import { bcs } from '@mysten/sui/bcs';
 import { DevInspectResults, getFullnodeUrl, SuiClient } from '@mysten/sui/client';
 import { Transaction } from '@mysten/sui/transactions';
+import { BigNumber } from 'bignumber.js';
 import {
   MARGIN_POOL_PARAM_KEY_STRUCT_MAP,
   MARGIN_POOL_PARAM_KEYS,
   MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS,
-} from '../testnet-config';
-import { bcs } from '@mysten/sui/bcs';
-import { TESTNET_COINS, TESTNET_MARGIN_POOLS, TESTNET_POOLS } from '../testnet-config';
+  MarginPoolParamKey,
+  MarginPoolWithSupplierCapParamKey,
+} from '../margin-pool-config';
+import { mul, normalize } from '../utils/math';
 import { NetworkType } from './types';
-import { BigNumber } from 'bignumber.js';
 
-type MarginPoolParamKey = (typeof MARGIN_POOL_PARAM_KEYS)[number];
-type MarginPoolWithSupplierCapParamKey = (typeof MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS)[number];
 type InterestConfig = {
-  midKink: number;
   highKink: number;
   baseBorrowApr: number;
-  midBorrowApr: number;
-  highBorrowApr: number;
+  borrowAprOnHighKink: number;
   maxBorrowApr: number;
-  borrowApr: number;
+  supplyApr: number;
+  utilizationRate: number;
 };
 export type MarginPoolParams = Record<
   MarginPoolParamKey | MarginPoolWithSupplierCapParamKey,
@@ -64,6 +63,13 @@ const isWithSupplierCapKey = (
   return _WITH_CAP_KEYS.has(key as string);
 };
 
+type DeepBookMarginPoolParams = {
+  address?: string;
+  suiClient?: SuiClient;
+  env?: NetworkType;
+  dbConfig?: DeepBookConfig;
+};
+
 /**
  * DeepBookMarginPool
  * -------------------
@@ -75,37 +81,32 @@ const isWithSupplierCapKey = (
 export class DeepBookMarginPool {
   marginPoolContract: MarginPoolContract;
   dbConfig: DeepBookConfig;
+  suiClient: SuiClient;
 
   /**
    * @param dbConfig - DeepBook configuration instance.
    * @param suiClient - Optional SuiClient; defaults to fullnode client based on config env.
    */
-  constructor(
-    env: NetworkType = 'testnet',
+  constructor({
+    env = 'mainnet',
     address = '',
-    readonly suiClient = new SuiClient({ url: getFullnodeUrl(env) }),
-    dbConfig?: DeepBookConfig
-  ) {
-    this.dbConfig =
-      dbConfig ??
-      new DeepBookConfig({
-        env,
-        address,
-        coins: TESTNET_COINS,
-        pools: TESTNET_POOLS,
-        marginPools: {
-          SUI: {
-            address: TESTNET_MARGIN_POOLS.SUI.address,
-            type: TESTNET_MARGIN_POOLS.SUI.coinType,
-          },
-          DBUSDC: {
-            address: TESTNET_MARGIN_POOLS.DBUSDC.address,
-            type: TESTNET_MARGIN_POOLS.DBUSDC.coinType,
-          },
-        },
-      });
+    suiClient = new SuiClient({
+      url: getFullnodeUrl(env),
+    }),
+    dbConfig = new DeepBookConfig({
+      env,
+      address,
+    }),
+  }: DeepBookMarginPoolParams = {}) {
+    this.dbConfig = dbConfig;
+    this.suiClient = suiClient;
+
     // Initialize smart contract wrapper
     this.marginPoolContract = new MarginPoolContract(this.dbConfig);
+
+    if (env !== this.env) {
+      throw new Error(`Mismatch between provided env (${env}) and dbConfig env (${this.env}).`);
+    }
   }
 
   get env() {
@@ -207,14 +208,13 @@ export class DeepBookMarginPool {
       lastUpdateTimestamp: 0,
       userSupplyShares: 0,
       userSupplyAmount: 0,
-      decimals: 0,
-      midKink: 0,
+      decimals: this.dbConfig.getCoin(coinKey).scalar.toString().length - 1,
       highKink: 0,
       baseBorrowApr: 0,
-      midBorrowApr: 0,
-      highBorrowApr: 0,
+      borrowAprOnHighKink: 0,
       maxBorrowApr: 0,
-      borrowApr: 0,
+      supplyApr: 0,
+      utilizationRate: 0,
       ...coin,
     };
 
@@ -242,94 +242,76 @@ export class DeepBookMarginPool {
     return formatted;
   }
 
-  #getCurrentBorrowApr(utilizationRate: bigint, interestConfig: RawInterestConfig) {
-    const baseRate = BigInt(interestConfig.base_rate); // B
-    const baseSlope = BigInt(interestConfig.base_slope); // S
-    const excessSlope = BigInt(interestConfig.excess_slope); // E
-    const optimalUtil = BigInt(interestConfig.optimal_utilization); // Uopt
-
-    // clamp U to [0, 1e9]
-    const U =
-      utilizationRate < 0n
-        ? 0n
-        : utilizationRate > BigInt(FLOAT_SCALAR)
-          ? BigInt(FLOAT_SCALAR)
-          : BigInt(utilizationRate);
-
-    if (U <= optimalUtil) {
-      // r(U) = B + S * U / Uopt
-      return baseRate + (baseSlope * U) / optimalUtil;
+  /**
+   * Compute the borrow APR based on utilization and interest config.
+   *
+   * if (U < optimal) {
+   *   r(U) = base_rate + mul(U, base_slope)
+   * } else {
+   *   r(U) = base_rate + mul(optimal, base_slope) + mul(U - optimal, excess_slope)
+   * }
+   */
+  #computeBorrowAprAtUtil(
+    util: bigint, // 1e9-scaled utilization
+    cfg: RawInterestConfig
+  ): bigint {
+    const baseRate = BigInt(cfg.base_rate);
+    const baseSlope = BigInt(cfg.base_slope);
+    const excessSlope = BigInt(cfg.excess_slope);
+    const optimalUtil = BigInt(cfg.optimal_utilization);
+
+    if (util < optimalUtil) {
+      return baseRate + mul(util, baseSlope);
     }
 
-    // r(U) = B + S + E * (U - Uopt) / (1 - Uopt)
-    return (
-      baseRate +
-      baseSlope +
-      (excessSlope * (U - optimalUtil)) / (BigInt(FLOAT_SCALAR) - optimalUtil)
-    );
+    return baseRate + mul(optimalUtil, baseSlope) + mul(util - optimalUtil, excessSlope);
   }
 
-  #calculateKinksAndBorrowApr(
+  #calculateKinksAndRate(
     interestConfig: RawInterestConfig,
     marginPoolConfig: RawMarginPoolConfig,
-    state: RawStatePoolConfig
+    state: RawStatePoolConfig,
+    borrowApr: number
   ) {
-    const baseRate = BigInt(interestConfig.base_rate);
-    const baseSlope = BigInt(interestConfig.base_slope);
-    const excessSlope = BigInt(interestConfig.excess_slope);
-    const optimalUtil = BigInt(interestConfig.optimal_utilization);
-    const maxUtil = BigInt(marginPoolConfig.max_utilization_rate);
-
-    // Kinks (still 1e9-scaled)
-    const midKink = optimalUtil;
-    const highKink = maxUtil;
-
-    // APRs in 1e9 scale
-    const baseBorrowApr = baseRate;
-    const midBorrowApr = baseRate + baseSlope;
-
-    // highBorrowApr at U = maxUtil
-    // r(U) = base + slope + excess * (U - optimal) / (1 - optimal)
-    const highBorrowApr =
-      baseRate +
-      baseSlope +
-      (excessSlope * (maxUtil - optimalUtil)) / (1_000_000_000n - optimalUtil);
-
-    // maxBorrowApr at U = 1.0 (i.e. 1e9)
-    const maxBorrowApr = baseRate + baseSlope + excessSlope;
-    const currentBorrowApr = this.#getCurrentBorrowApr(
-      BigInt(
-        BigNumber(state.total_borrow)
-          .dividedBy(state.total_supply)
-          .shiftedBy(9)
-          .decimalPlaces(0)
-          .toString()
-      ),
-      interestConfig
+    const highKink = BigInt(interestConfig.optimal_utilization); // v0
+    const maxKink = BigInt(marginPoolConfig.max_utilization_rate); // U_max
+
+    // const midBorrowApr = this.#computeBorrowAprAtUtil(midKink, interestConfig);
+    const borrowAprOnHighKink = this.#computeBorrowAprAtUtil(highKink, interestConfig);
+    const maxBorrowApr = this.#computeBorrowAprAtUtil(maxKink, interestConfig);
+
+    const utilizationRate = BigInt(
+      BigNumber(state.total_borrow)
+        .dividedBy(state.total_supply)
+        .shiftedBy(9)
+        .decimalPlaces(0)
+        .toString()
+    );
+    const supplyApr = mul(
+      mul(BigInt(borrowApr), utilizationRate),
+      BigInt(FLOAT_SCALAR) - BigInt(marginPoolConfig.protocol_spread)
     );
-
-    const normalize = (value: bigint) => BigNumber(value).dividedBy(FLOAT_SCALAR).toNumber();
 
     return {
-      // raw 1e9-scaled values (BigInt)
+      // raw 1e9-scaled values
       raw: {
-        midKink,
-        highKink,
-        baseBorrowApr,
-        midBorrowApr,
-        highBorrowApr,
-        maxBorrowApr,
-        borrowApr: currentBorrowApr,
+        baseBorrowApr: interestConfig.base_rate,
+        highKink, // utilization at kink2
+        borrowAprOnHighKink, // APR at highKink
+        maxBorrowApr, // APR at U = 1.0
+        supplyApr,
+        utilizationRate,
       },
-      // convenience: normalized numbers (e.g. 0.125 = 12.5%)
+      // convenience normalized numbers
       normalized: {
-        midKink: normalize(midKink),
+        baseBorrowApr: normalize(BigInt(interestConfig.base_rate)),
+        // midKink: normalize(midKink),
         highKink: normalize(highKink),
-        baseBorrowApr: normalize(baseBorrowApr),
-        midBorrowApr: normalize(midBorrowApr),
-        highBorrowApr: normalize(highBorrowApr),
+        // midBorrowApr: normalize(midBorrowApr),
+        borrowAprOnHighKink: normalize(borrowAprOnHighKink),
         maxBorrowApr: normalize(maxBorrowApr),
-        borrowApr: normalize(currentBorrowApr),
+        supplyApr: normalize(supplyApr),
+        utilizationRate: normalize(utilizationRate),
       },
     };
   }
@@ -339,7 +321,7 @@ export class DeepBookMarginPool {
    * @param coinKey - Asset key.
    * @returns Interest configuration data including kinks and APRs.
    */
-  async #getInterestConfig(coinKey: string) {
+  async #getInterestConfig(coinKey: string, interestRate: number) {
     const { address } = this.dbConfig.getMarginPool(coinKey);
     const response = await this.suiClient.getObject({
       id: address,
@@ -353,10 +335,11 @@ export class DeepBookMarginPool {
     const interestConfig = config.interest_config.fields as RawInterestConfig;
     const marginPoolConfig = config.margin_pool_config.fields as RawMarginPoolConfig;
     const statePoolConfig = fields.state.fields as RawStatePoolConfig;
-    const { normalized } = this.#calculateKinksAndBorrowApr(
+    const { normalized } = this.#calculateKinksAndRate(
       interestConfig,
       marginPoolConfig,
-      statePoolConfig
+      statePoolConfig,
+      interestRate
     );
     return normalized;
   }
@@ -426,11 +409,14 @@ export class DeepBookMarginPool {
       sender: this.dbConfig.address,
     });
 
-    const interestData = await this.#getInterestConfig(coinKey);
     const formattedResult = this.#formatResult(
       this.#parseInspectResultToBcsStructs(inspectResult, allKeys),
       coinKey
     );
+    const interestData = await this.#getInterestConfig(
+      coinKey,
+      formattedResult.interestRate * FLOAT_SCALAR
+    );
 
     return {
       ...formattedResult,

package/src/toolkit/DeepBookMarginToolkit.ts

@@ -35,12 +35,6 @@ import { SuiClient, getFullnodeUrl } from '@mysten/sui/client';
 import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
 import { Transaction } from '@mysten/sui/transactions';
 import { MarginPoolContract, DeepBookConfig } from '@mysten/deepbook-v3';
-import {
-  TESTNET_COINS,
-  TESTNET_POOLS,
-  TESTNET_MARGIN_POOLS,
-  TESTNET_PACKAGES,
-} from '../testnet-config';
 import { ToolkitConfig, MarginCoinType, MarginBalance } from './types';
 import { decodeSuiPrivateKey, SUI_PRIVATE_KEY_PREFIX } from '@mysten/sui/cryptography';
 import { hexOrBase64ToUint8Array, normalizePrivateKey } from '../utils/private-key';
@@ -54,70 +48,40 @@ export class DeepBookMarginToolkit {
   private address: string;
   private marginPoolContract: MarginPoolContract;
   private supplierCapId?: string;
-
-  constructor(config: ToolkitConfig) {
+  private dbConfig: DeepBookConfig;
+  private supplierCapPackageId: string;
+
+  constructor({
+    network,
+    fullnodeUrl,
+    supplierCapId,
+    privateKey,
+    supplierCapPackageId,
+    dbConfig,
+  }: ToolkitConfig) {
     // Initialize SuiClient | 初始化 SuiClient
-    const rpcUrl = config.fullnodeUrl ?? getFullnodeUrl(config.network);
+    const rpcUrl = fullnodeUrl ?? getFullnodeUrl(network);
     this.suiClient = new SuiClient({ url: rpcUrl });
 
     // Initialize keypair | 初始化密鑰對
-    this.keypair = this.#parseSecretKey(config.privateKey);
+    this.keypair = this.#parseSecretKey(privateKey);
     this.address = this.keypair.getPublicKey().toSuiAddress();
 
     // Store Supplier Cap ID if provided | 儲存 Supplier Cap ID（如果提供）
-    this.supplierCapId = config.supplierCapId;
-
-    // Prepare coins configuration | 準備 coins 配置
-    const coins = {
-      DEEP: {
-        address: TESTNET_COINS.DEEP.address,
-        type: TESTNET_COINS.DEEP.type,
-        scalar: TESTNET_COINS.DEEP.scalar,
-      },
-      SUI: {
-        address: TESTNET_COINS.SUI.address,
-        type: TESTNET_COINS.SUI.type,
-        scalar: TESTNET_COINS.SUI.scalar,
-      },
-      DBUSDC: {
-        address: TESTNET_COINS.DBUSDC.address,
-        type: TESTNET_COINS.DBUSDC.type,
-        scalar: TESTNET_COINS.DBUSDC.scalar,
-      },
-    };
-
-    // Prepare pools configuration | 準備 pools 配置
-    const pools = {
-      SUI_DBUSDC: {
-        address: TESTNET_POOLS.SUI_DBUSDC.address,
-        baseCoin: TESTNET_POOLS.SUI_DBUSDC.baseCoin,
-        quoteCoin: TESTNET_POOLS.SUI_DBUSDC.quoteCoin,
-      },
-    };
-
-    // Prepare margin pools configuration | 準備 margin pools 配置
-    const marginPools = {
-      SUI: {
-        address: TESTNET_MARGIN_POOLS.SUI.address,
-        type: TESTNET_MARGIN_POOLS.SUI.coinType,
-      },
-      DBUSDC: {
-        address: TESTNET_MARGIN_POOLS.DBUSDC.address,
-        type: TESTNET_MARGIN_POOLS.DBUSDC.coinType,
-      },
-    };
+    this.supplierCapId = supplierCapId;
 
     // Create DeepBookConfig | 創建 DeepBookConfig
-    const deepbookConfig = new DeepBookConfig({
-      address: this.address,
-      env: config.network,
-      coins,
-      pools,
-      marginPools,
-    });
+    this.dbConfig =
+      dbConfig ??
+      new DeepBookConfig({
+        env: network,
+        address: this.address,
+      });
 
     // Initialize MarginPoolContract | 初始化 MarginPoolContract
-    this.marginPoolContract = new MarginPoolContract(deepbookConfig);
+    this.marginPoolContract = new MarginPoolContract(this.dbConfig);
+
+    this.supplierCapPackageId = supplierCapPackageId ?? this.dbConfig.MARGIN_PACKAGE_ID;
   }
 
   #parseSecretKey(secretKey: string): Ed25519Keypair {
@@ -129,8 +93,9 @@ export class DeepBookMarginToolkit {
     return Ed25519Keypair.fromSecretKey(normalizePrivateKey(hexOrBase64ToUint8Array(secretKey)));
   }
 
+  // @TODO: Handle more than 1 supplier cap in future
   async #getExistingSupplierCapId() {
-    const type = `${TESTNET_PACKAGES.MARGIN_INITIAL_PACKAGE_ID}::margin_pool::SupplierCap`;
+    const type = `${this.dbConfig.MARGIN_PACKAGE_ID}::margin_pool::SupplierCap`;
     const resp = await this.suiClient.getOwnedObjects({
       owner: this.address,
       filter: {
@@ -179,10 +144,17 @@ export class DeepBookMarginToolkit {
   async createSupplierCap(): Promise<string | null> {
     try {
       const tx = new Transaction();
+      tx.setSender(this.address);
+
+      // Direct moveCall to get the returned object reference
+      // Based on SDK source: margin_pool::mint_supplier_cap
+      const supplierCap = tx.moveCall({
+        target: `${this.supplierCapPackageId}::margin_pool::mint_supplier_cap`,
+        arguments: [tx.object(this.dbConfig.MARGIN_REGISTRY_ID), tx.object.clock()],
+      });
 
-      // Use MarginPoolContract to create Supplier Cap | 使用 MarginPoolContract 創建 Supplier Cap
-      const cap = this.marginPoolContract.mintSupplierCap()(tx);
-      tx.transferObjects([cap], this.address);
+      // Transfer the created Supplier Cap to the sender
+      tx.transferObjects([supplierCap], tx.pure.address(this.address));
 
       const result = await this.suiClient.signAndExecuteTransaction({
         signer: this.keypair,
@@ -222,9 +194,25 @@ export class DeepBookMarginToolkit {
   async createSupplyReferral(coin: MarginCoinType): Promise<string | null> {
     try {
       const tx = new Transaction();
+      tx.setSender(this.address);
+
+      // Get margin pool configuration
+      const marginPool = this.dbConfig.getMarginPool(coin);
+      if (!marginPool) {
+        throw new Error(`Margin pool configuration not found for coin: ${coin}`);
+      }
 
-      // Use MarginPoolContract to create supply Referral | 使用 MarginPoolContract 創建供應 Referral
-      this.marginPoolContract.mintSupplyReferral(coin)(tx);
+      // Use the initialVersion from config as the initial_shared_version
+      // Margin pools are shared objects on Sui
+      tx.moveCall({
+        target: `${this.dbConfig.MARGIN_PACKAGE_ID}::margin_pool::mint_supply_referral`,
+        arguments: [
+          tx.object(marginPool.address),
+          tx.object(this.dbConfig.MARGIN_REGISTRY_ID),
+          tx.object.clock(),
+        ],
+        typeArguments: [marginPool.type],
+      });
 
       const result = await this.suiClient.signAndExecuteTransaction({
         signer: this.keypair,
@@ -411,19 +399,19 @@ export class DeepBookMarginToolkit {
         if (supplyData && supplyData[0]) {
           const rawAmount = Buffer.from(supplyData[0]).readBigUInt64LE();
           // Convert from smallest unit to human-readable | 從最小單位轉換為人類可讀
-          const scalar = coin === 'SUI' ? TESTNET_COINS.SUI.scalar : TESTNET_COINS.DBUSDC.scalar;
+          const scalar = this.dbConfig.getCoin(coin).scalar;
           userSupplyAmount = Number(rawAmount) / scalar;
         }
       }
 
       // Query wallet balance | 查詢錢包餘額
-      const coinType = coin === 'SUI' ? TESTNET_COINS.SUI.type : TESTNET_COINS.DBUSDC.type;
+      const coinType = this.dbConfig.getCoin(coin).type;
       const balance = await this.suiClient.getBalance({
         owner: this.address,
         coinType,
       });
 
-      const scalar = coin === 'SUI' ? TESTNET_COINS.SUI.scalar : TESTNET_COINS.DBUSDC.scalar;
+      const scalar = this.dbConfig.getCoin(coin).scalar;
       const walletBalance = Number(balance.totalBalance) / scalar;
 
       return {

package/src/toolkit/types.ts

@@ -2,6 +2,8 @@
  * Type definitions for DeepBook Margin Toolkit | DeepBook Margin Toolkit 類型定義
  */
 
+import { DeepBookConfig } from '@mysten/deepbook-v3';
+
 // ============================================================================
 // Network & Configuration Types | 網路與配置類型
 // ============================================================================
@@ -31,6 +33,11 @@ export interface ToolkitConfig {
 
   /** Optional: custom fullnode URL | 可選：自訂 fullnode URL */
   fullnodeUrl?: string;
+
+  /** Optional: Supplier Cap Object type ID | 可選：Supplier Cap 物件類型 ID */
+  supplierCapPackageId?: string;
+
+  dbConfig?: DeepBookConfig;
 }
 
 /**
@@ -71,3 +78,56 @@ export interface ReferralInfo {
   /** Owner address | 擁有者地址 */
   owner: string;
 }
+
+// ============================================================================
+// Margin Pool Parameter Types | Margin Pool 參數類型
+// ============================================================================
+
+/**
+ * Margin pool configuration parameters | Margin pool 配置參數
+ */
+export interface MarginPoolConfig {
+  /** Pool address | 池子地址 */
+  address: string;
+
+  /** Coin type | 幣種類型 */
+  coinType: string;
+
+  /** Initial version | 初始版本 */
+  initialVersion: number;
+
+  /** Supply cap | 供應上限 */
+  supplyCap: number;
+
+  /** Max utilization rate | 最大使用率 */
+  maxUtilizationRate: number;
+
+  /** Referral spread | Referral spread */
+  referralSpread: number;
+
+  /** Min borrow amount | 最小借款額 */
+  minBorrow: number;
+}
+
+/**
+ * Risk parameters for a trading pair | 交易對的風險參數
+ */
+export interface RiskParameters {
+  /** Min withdraw risk ratio | 最小提款風險比率 */
+  minWithdrawRiskRatio: number;
+
+  /** Min borrow risk ratio | 最小借款風險比率 */
+  minBorrowRiskRatio: number;
+
+  /** Liquidation risk ratio | 清算風險比率 */
+  liquidationRiskRatio: number;
+
+  /** Target liquidation risk ratio | 目標清算風險比率 */
+  targetLiquidationRiskRatio: number;
+
+  /** User liquidation reward | 用戶清算獎勵 */
+  userLiquidationReward: number;
+
+  /** Pool liquidation reward | 池子清算獎勵 */
+  poolLiquidationReward: number;
+}

package/src/utils/math.ts

@@ -0,0 +1,4 @@
+import { FLOAT_SCALAR } from '@mysten/deepbook-v3';
+
+export const mul = (a: bigint, b: bigint): bigint => (a * b) / BigInt(FLOAT_SCALAR);
+export const normalize = (value: bigint): number => Number(value) / FLOAT_SCALAR; // e.g. 0.12 = 12%

package/src/testnet-config.ts

@@ -1,229 +0,0 @@
-/**
- * DeepBook V3 & Margin Testnet Configuration | DeepBook V3 & Margin 測試網配置
- * Source | 來源: https://github.com/MystenLabs/ts-sdks/tree/main/packages/deepbook-v3
- * Last updated | 最後更新: 2025-11-11
- */
-
-// ============================================================================
-// Package IDs
-// ============================================================================
-
-export const TESTNET_PACKAGES = {
-  DEEPBOOK_PACKAGE_ID: '0xfb28c4cbc6865bd1c897d26aecbe1f8792d1509a20ffec692c800660cbec6982',
-  REGISTRY_ID: '0x7c256edbda983a2cd6f946655f4bf3f00a41043993781f8674a7046e8c0e11d1',
-  DEEP_TREASURY_ID: '0x69fffdae0075f8f71f4fa793549c11079266910e8905169845af1f5d00e09dcb',
-  MARGIN_PACKAGE_ID: '0x7f2d8f15343f210e813595a8798d6197d152061d0a35be938372f4b1cd66f209',
-  MARGIN_INITIAL_PACKAGE_ID: '0x7f2d8f15343f210e813595a8798d6197d152061d0a35be938372f4b1cd66f209', // for events
-  MARGIN_REGISTRY_ID: '0x31b9086767e9b5925cb29414ea623a7705b5600d9594d88c17c7a011cb499ab4',
-} as const;
-
-// ============================================================================
-// Coin Configuration | 代幣配置
-// ============================================================================
-
-export const TESTNET_COINS = {
-  DEEP: {
-    address: '0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8',
-    type: '0x36dbef866a1d62bf7328989a10fb2f07d769f4ee587c0de4a0a256e57e0a58a8::deep::DEEP',
-    scalar: 1_000_000,
-    decimals: 6,
-  },
-  SUI: {
-    address: '0x0000000000000000000000000000000000000000000000000000000000000002',
-    type: '0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI',
-    scalar: 1_000_000_000,
-    decimals: 9,
-  },
-  DBUSDC: {
-    address: '0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7',
-    type: '0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7::DBUSDC::DBUSDC',
-    scalar: 1_000_000,
-    decimals: 6,
-  },
-  DBUSDT: {
-    address: '0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7',
-    type: '0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7::DBUSDT::DBUSDT',
-    scalar: 1_000_000,
-    decimals: 6,
-  },
-  WAL: {
-    address: '0x9ef7676a9f81937a52ae4b2af8d511a28a0b080477c0c2db40b0ab8882240d76',
-    type: '0x9ef7676a9f81937a52ae4b2af8d511a28a0b080477c0c2db40b0ab8882240d76::wal::WAL',
-    scalar: 1_000_000_000,
-    decimals: 9,
-  },
-} as const;
-
-// ============================================================================
-// Trading Pool Configuration | 交易池配置
-// ============================================================================
-
-export const TESTNET_POOLS = {
-  DEEP_SUI: {
-    // Actual pool address on testnet (verified 2025-11-11) | 實際存在於 testnet 上的 Pool 地址（2025-11-11 驗證）
-    address: '0x48c95963e9eac37a316b7ae04a0deb761bcdcc2b67912374d6036e7f0e9bae9f',
-    baseCoin: 'DEEP',
-    quoteCoin: 'SUI',
-    lotSize: 1_000_000, // 1 DEEP (6 decimals) | 1 DEEP（6 位小數）
-    tickSize: 1_000_000, // 0.001 SUI (9 decimals) | 0.001 SUI（9 位小數）
-  },
-  SUI_DBUSDC: {
-    // Actual pool address on testnet (verified 2025-11-11) | 實際存在於 testnet 上的 Pool 地址（2025-11-11 驗證）
-    address: '0x1c19362ca52b8ffd7a33cee805a67d40f31e6ba303753fd3a4cfdfacea7163a5',
-    baseCoin: 'SUI',
-    quoteCoin: 'DBUSDC',
-    lotSize: 1_000_000, // 0.001 SUI (9 decimals) | 0.001 SUI（9 位小數）
-    tickSize: 1_000, // 0.001 DBUSDC (6 decimals) | 0.001 DBUSDC（6 位小數）
-  },
-  DEEP_DBUSDC: {
-    // Actual pool address on testnet (verified 2025-11-11) | 實際存在於 testnet 上的 Pool 地址（2025-11-11 驗證）
-    address: '0xe86b991f8632217505fd859445f9803967ac84a9d4a1219065bf191fcb74b622',
-    baseCoin: 'DEEP',
-    quoteCoin: 'DBUSDC',
-    lotSize: 1_000_000, // 1 DEEP (6 decimals) | 1 DEEP（6 位小數）
-    tickSize: 1_000, // 0.001 DBUSDC (6 decimals) | 0.001 DBUSDC（6 位小數）
-  },
-  DBUSDT_DBUSDC: {
-    // Actual pool address on testnet (verified 2025-11-11) | 實際存在於 testnet 上的 Pool 地址（2025-11-11 驗證）
-    address: '0x83970bb02e3636efdff8c141ab06af5e3c9a22e2f74d7f02a9c3430d0d10c1ca',
-    baseCoin: 'DBUSDT',
-    quoteCoin: 'DBUSDC',
-    lotSize: 1_000_000, // 1 DBUSDT (6 decimals) | 1 DBUSDT（6 位小數）
-    tickSize: 1_000, // 0.001 DBUSDC (6 decimals) | 0.001 DBUSDC（6 位小數）
-  },
-  WAL_DBUSDC: {
-    // Actual pool address on testnet (verified 2025-11-11) | 實際存在於 testnet 上的 Pool 地址（2025-11-11 驗證）
-    address: '0xeb524b6aea0ec4b494878582e0b78924208339d360b62aec4a8ecd4031520dbb',
-    baseCoin: 'WAL',
-    quoteCoin: 'DBUSDC',
-    lotSize: 1_000_000, // 0.001 WAL (9 decimals) | 0.001 WAL（9 位小數）
-    tickSize: 1_000, // 0.001 DBUSDC (6 decimals) | 0.001 DBUSDC（6 位小數）
-  },
-  WAL_SUI: {
-    // Actual pool address on testnet (verified 2025-11-11) | 實際存在於 testnet 上的 Pool 地址（2025-11-11 驗證）
-    address: '0x8c1c1b186c4fddab1ebd53e0895a36c1d1b3b9a77cd34e607bef49a38af0150a',
-    baseCoin: 'WAL',
-    quoteCoin: 'SUI',
-    lotSize: 1_000_000, // 0.001 WAL (9 decimals) | 0.001 WAL（9 位小數）
-    tickSize: 1_000_000, // 0.001 SUI (9 decimals) | 0.001 SUI（9 位小數）
-  },
-} as const;
-
-// ============================================================================
-// Margin Pool Configuration | Margin 池配置
-// ============================================================================
-
-export const TESTNET_MARGIN_POOLS = {
-  SUI: {
-    // Actual margin pool address on testnet (verified 2025-11-11) | 實際存在於 testnet 上的 Margin Pool 地址（2025-11-11 驗證）
-    address: '0xe620d6a5390e57e88baff18af89383130d4210eb496a024edcd62f270a655af7',
-    coinType: '0x2::sui::SUI',
-  },
-  DBUSDC: {
-    // Actual margin pool address on testnet (verified 2025-11-11) | 實際存在於 testnet 上的 Margin Pool 地址（2025-11-11 驗證）
-    address: '0xfd0dc290a120ad6c534507614d4dc0b2e78baab649c35bfacbaec2ce18140b69',
-    coinType: '0xf7152c05930480cd740d7311b5b8b45c6f488e3a53a11c3f74a6fac36a52e0d7::DBUSDC::DBUSDC',
-  },
-} as const;
-
-// ============================================================================
-// Pyth Oracle Configuration | Pyth Oracle 配置
-// ============================================================================
-
-export const TESTNET_PYTH = {
-  pythStateId: '0x243759059f4c3111179da5878c12f68d612c21a8d54d85edc86164bb18be1c7c',
-  wormholeStateId: '0x31358d198147da50db32eda2562951d53973a0c0ad5ed738e9b17d88b213d790',
-} as const;
-
-// ============================================================================
-// Pool Keys (SDK shorthand) | Pool Keys（SDK 使用的簡寫）
-// ============================================================================
-
-export const TESTNET_POOL_KEYS = [
-  'DEEP_SUI',
-  'SUI_DBUSDC',
-  'DEEP_DBUSDC',
-  'DBUSDT_DBUSDC',
-  'WAL_DBUSDC',
-  'WAL_SUI',
-] as const;
-
-export type TestnetPoolKey = (typeof TESTNET_POOL_KEYS)[number];
-
-// ============================================================================
-// Margin Pool Contract Parameter Keys | Margin Pool 合約參數鍵
-// ============================================================================
-
-export const MARGIN_POOL_PARAM_KEYS = [
-  'supplyCap',
-  'maxUtilizationRate',
-  'protocolSpread',
-  'minBorrow',
-  'interestRate',
-  'totalSupply',
-  'supplyShares',
-  'totalBorrow',
-  'borrowShares',
-  'lastUpdateTimestamp',
-] as const;
-
-export const MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS = [
-  'userSupplyShares',
-  'userSupplyAmount',
-] as const;
-
-export const MARGIN_POOL_PARAM_KEY_STRUCT_MAP = {
-  supplyCap: 'U64',
-  maxUtilizationRate: 'U64',
-  protocolSpread: 'U64',
-  minBorrow: 'U64',
-  interestRate: 'U64',
-  totalSupply: 'U64',
-  supplyShares: 'U64',
-  totalBorrow: 'U64',
-  borrowShares: 'U64',
-  lastUpdateTimestamp: 'U64',
-  userSupplyShares: 'U64',
-  userSupplyAmount: 'U64',
-} as Record<
-  (typeof MARGIN_POOL_PARAM_KEYS)[number] | (typeof MARGIN_POOL_W_SUPPLIER_CAP_PARAM_KEYS)[number],
-  'U64'
->;
-
-// ============================================================================
-// Utility Functions | 輔助函數
-// ============================================================================
-
-/**
- * Get full pool configuration | 取得 Pool 的完整配置
- */
-export function getPoolConfig(poolKey: TestnetPoolKey) {
-  return TESTNET_POOLS[poolKey];
-}
-
-/**
- * Get full coin configuration | 取得代幣的完整配置
- */
-export function getCoinConfig(coinSymbol: keyof typeof TESTNET_COINS) {
-  return TESTNET_COINS[coinSymbol];
-}
-
-/**
- * Format coin amount (convert from smallest unit to human-readable) | 格式化代幣數量（從最小單位轉換為人類可讀）
- */
-export function formatCoinAmount(
-  amount: number | bigint,
-  coinSymbol: keyof typeof TESTNET_COINS
-): string {
-  const config = TESTNET_COINS[coinSymbol];
-  const value = Number(amount) / config.scalar;
-  return value.toFixed(config.decimals);
-}
-
-/**
- * Parse coin amount (convert from human-readable to smallest unit) | 解析代幣數量（從人類可讀轉換為最小單位）
- */
-export function parseCoinAmount(amount: number, coinSymbol: keyof typeof TESTNET_COINS): number {
-  const config = TESTNET_COINS[coinSymbol];
-  return Math.floor(amount * config.scalar);
-}