@1stdex/first-sdk 1.0.5 → 1.0.7

package/dist/types/calls/approval/order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../../src/calls/approval/order.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIvE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,wBAAwB,2DAMlC;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,KAAG,QAAQ,WAAW,CAqCtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gCAAgC,uCAI1C;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,KAAG,QAAQ,WAAW,CAQtB,CAAC"}
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../../src/calls/approval/order.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIvE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,wBAAwB,2DAMlC;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,KAAG,QAAQ,WAAW,CA6BtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gCAAgC,uCAI1C;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,KAAG,QAAQ,WAAW,CAQtB,CAAC"}

package/dist/types/calls/approval/token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../../src/calls/approval/token.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,kBAAkB,qDAK5B;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,KAAG,QAAQ,WAAW,EAAE,CAkIxB,CAAC"}
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../../src/calls/approval/token.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAOvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,kBAAkB,qDAK5B;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACvC,KAAG,QAAQ,WAAW,EAAE,CA+GxB,CAAC"}

package/dist/types/views/index.d.ts

@@ -7,4 +7,5 @@ export { getCurrencies, getStableCurrencies, getLatestPriceMap, getDailyClosePri
 export { getProtocolAnalytics, getUserDailyVolumes, getTopUsersByNativeVolume, getUserNativeVolume, getReferralSummary, } from './analytics';
 export { getVault } from './vault';
 export { getTradingBalance } from './balance';
+export { isOrderOperatorApproved, checkTokenAllowances, needsVaultDeposit, getOrderSetupStatus, } from './setup';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/views/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/views/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/views/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/types/views/setup.d.ts

@@ -0,0 +1,133 @@
+import { CHAIN_IDS } from '../constants/chain-configs/chain';
+import { CurrencyAmount } from '../types';
+/**
+ * Check if an operator is approved for a user.
+ *
+ * @param chainId The chain ID.
+ * @param userAddress The user address.
+ * @param operator The operator address (defaults to Controller).
+ * @param options Optional RPC URL.
+ * @returns Promise resolving to true if operator is approved.
+ * @example
+ * import { isOrderOperatorApproved } from '@clober/v2-sdk'
+ *
+ * const isApproved = await isOrderOperatorApproved({
+ *   chainId: 421614,
+ *   userAddress: '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69'
+ * })
+ */
+export declare const isOrderOperatorApproved: ({ chainId, userAddress, operator, options, }: {
+    chainId: CHAIN_IDS;
+    userAddress: `0x${string}`;
+    operator?: `0x${string}`;
+    options?: {
+        rpcUrl?: string;
+    };
+}) => Promise<boolean>;
+/**
+ * Check token allowances for trading.
+ * Returns which allowances are sufficient (above threshold).
+ *
+ * @param chainId The chain ID.
+ * @param userAddress The user address.
+ * @param tokenAddress The token address.
+ * @param options Optional RPC URL.
+ * @returns Promise resolving to allowance status object.
+ * @example
+ * import { checkTokenAllowances } from '@clober/v2-sdk'
+ *
+ * const status = await checkTokenAllowances({
+ *   chainId: 421614,
+ *   userAddress: '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69',
+ *   tokenAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0'
+ * })
+ * if (!status.tokenToController) {
+ *   // Need to set token allowances
+ * }
+ */
+export declare const checkTokenAllowances: ({ chainId, userAddress, tokenAddress, options, }: {
+    chainId: CHAIN_IDS;
+    userAddress: `0x${string}`;
+    tokenAddress: `0x${string}`;
+    options?: {
+        rpcUrl?: string;
+    };
+}) => Promise<{
+    tokenToController: boolean;
+    vaultToController: boolean;
+    vaultToBookManager: boolean;
+}>;
+/**
+ * Check if vault deposit is needed for an order.
+ * Compares vault available balance against required amount.
+ *
+ * @param chainId The chain ID.
+ * @param userAddress The user address.
+ * @param tokenAddress The token address.
+ * @param requiredAmount The amount needed (decimal-adjusted string, e.g., "100.5").
+ * @param options Optional RPC URL.
+ * @returns Promise resolving to true if deposit is needed.
+ * @example
+ * import { needsVaultDeposit } from '@clober/v2-sdk'
+ *
+ * const needsDeposit = await needsVaultDeposit({
+ *   chainId: 421614,
+ *   userAddress: '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69',
+ *   tokenAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *   requiredAmount: "100"
+ * })
+ */
+export declare const needsVaultDeposit: ({ chainId, userAddress, tokenAddress, requiredAmount, options, }: {
+    chainId: CHAIN_IDS;
+    userAddress: `0x${string}`;
+    tokenAddress: `0x${string}`;
+    requiredAmount: string;
+    options?: {
+        rpcUrl?: string;
+    };
+}) => Promise<boolean>;
+/**
+ * Get complete order setup status in a single call.
+ * Checks operator approval, token allowances, and vault balance.
+ *
+ * @param chainId The chain ID.
+ * @param userAddress The user address.
+ * @param tokenAddress The token address.
+ * @param requiredAmount The amount needed for the order (decimal-adjusted string).
+ * @param options Optional RPC URL and operator address.
+ * @returns Promise resolving to complete setup status.
+ * @example
+ * import { getOrderSetupStatus } from '@clober/v2-sdk'
+ *
+ * const status = await getOrderSetupStatus({
+ *   chainId: 421614,
+ *   userAddress: '0xF8c1869Ecd4df136693C45EcE1b67f85B6bDaE69',
+ *   tokenAddress: '0x00bfd44e79fb7f6dd5887a9426c8ef85a0cd23e0',
+ *   requiredAmount: "100"
+ * })
+ *
+ * if (!status.operatorApproved) await setOrderOperatorApproval(...)
+ * if (!status.allAllowancesSet) await setTokenAllowances(...)
+ * if (status.needsDeposit) await depositToVault(...)
+ */
+export declare const getOrderSetupStatus: ({ chainId, userAddress, tokenAddress, requiredAmount, options, }: {
+    chainId: CHAIN_IDS;
+    userAddress: `0x${string}`;
+    tokenAddress: `0x${string}`;
+    requiredAmount: string;
+    options?: {
+        rpcUrl?: string;
+        operator?: `0x${string}`;
+    };
+}) => Promise<{
+    operatorApproved: boolean;
+    tokenAllowances: {
+        tokenToController: boolean;
+        vaultToController: boolean;
+        vaultToBookManager: boolean;
+        allSet: boolean;
+    };
+    vaultBalance: CurrencyAmount;
+    needsDeposit: boolean;
+}>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/types/views/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/views/setup.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAa,MAAM,kCAAkC,CAAC;AAMxE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,iDAKjC;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,KAAG,QAAQ,OAAO,CAclB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,qDAK9B;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,KAAG,QAAQ;IACV,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAiDA,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,qEAM3B;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,KAAG,QAAQ,OAAO,CAoBlB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB,qEAM7B;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,CAAC;CACzD,KAAG,QAAQ;IACV,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE;QACf,iBAAiB,EAAE,OAAO,CAAC;QAC3B,iBAAiB,EAAE,OAAO,CAAC;QAC3B,kBAAkB,EAAE,OAAO,CAAC;QAC5B,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,YAAY,EAAE,cAAc,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;CACvB,CA+EA,CAAC"}

package/dist/types/views/vault.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../../src/views/vault.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,kCAAkC,CAAC;AAGxE,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,wCAIlB;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,KAAG,QAAQ,KAAK,CAgBhB,CAAC"}
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../../src/views/vault.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAa,MAAM,kCAAkC,CAAC;AAGxE,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,wCAIlB;IACD,OAAO,EAAE,SAAS,CAAC;IACnB,YAAY,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B,KAAG,QAAQ,KAAK,CAqBhB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1stdex/first-sdk",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "🛠 An SDK for building applications on top of 1st V2",
   "files": [
     "dist"