@zofai/zo-sdk 0.1.92

package/dist/oracle.mjs

@@ -0,0 +1,114 @@
+import { Transaction } from "@mysten/sui/transactions";
+import { SuiPriceServiceConnection, SuiPythClient } from "@pythnetwork/pyth-sui-js";
+import { getConsts, getPriceIdToPythFeeder, getPythFeederToId, getPythFeederToPriceId, getSharedConfig, LPToken } from "./consts/index.mjs";
+import { createJsonRpcProvider } from "./utils.mjs";
+export class OracleAPI {
+    constructor(network, provider, 
+    // todo 需要从配置文件中获取
+    connectionURL, lpToken = LPToken.ZLP) {
+        this.priceCache = {};
+        this.network = network;
+        this.consts = getConsts(network, lpToken);
+        this.sharedConfig = getSharedConfig(network);
+        this.connectionURL = connectionURL;
+        this.PythFeederToPriceId = getPythFeederToPriceId(network);
+        this.PythFeederToId = getPythFeederToId(network);
+        this.provider = provider || createJsonRpcProvider(network);
+        this.client = new SuiPythClient(this.provider, this.consts.pythFeeder.state, this.consts.pythFeeder.wormhole.state);
+    }
+    validateCache() {
+        const now = Date.now() / 1000;
+        for (const key in this.priceCache) {
+            if (now - (this.priceCache[key].getPriceUnchecked().publishTime || 0) > 7) {
+                delete this.priceCache[key];
+            }
+        }
+    }
+    async getOraclePrice(tokenId) {
+        this.validateCache();
+        if (this.priceCache[tokenId]) {
+            return this.priceCache[tokenId];
+        }
+        const res = await this.getOraclePrices([tokenId]);
+        if (!res || !res[0]) {
+            throw new Error(`Unknown token: ${tokenId}`);
+        }
+        this.priceCache[tokenId] = res[0];
+        return res[0];
+    }
+    async getOraclePrices(tokens) {
+        const connection = new SuiPriceServiceConnection(this.connectionURL, {
+            priceFeedRequestConfig: {
+                binary: true,
+            },
+        });
+        const pythObjectIds = tokens.map(token => this.consts.pythFeeder.feeder[token]);
+        const priceFeedIds = pythObjectIds.map(pythObjectId => `0x${this.PythFeederToPriceId[pythObjectId]}`);
+        const price = await connection.getLatestPriceFeeds(priceFeedIds);
+        return price || [];
+    }
+    // memory leak
+    async subOraclePrices(tokens, callback) {
+        const connection = new SuiPriceServiceConnection(this.connectionURL, {
+            priceFeedRequestConfig: {
+                binary: true,
+            },
+        });
+        const pythObjectIds = tokens.map(token => this.consts.pythFeeder.feeder[token]);
+        const priceFeedIds = pythObjectIds.map(pythObjectId => `0x${this.PythFeederToPriceId[pythObjectId]}`);
+        await connection.subscribePriceFeedUpdates(priceFeedIds, (price) => {
+            price.id = this.PythFeederToId[getPriceIdToPythFeeder(this.network)[price.id]];
+            this.priceCache[price.id] = price;
+            callback(price);
+        });
+        return () => {
+            connection.unsubscribePriceFeedUpdates(priceFeedIds);
+        };
+    }
+    async initOracleTxb(tokens, tx, sponsoredTx, suiCoinObject) {
+        let tx_ = tx;
+        if (!tx_) {
+            tx_ = new Transaction();
+        }
+        // Remove redundant tokens first
+        const uniqueTokens = Array.from(new Set(tokens));
+        const connection = new SuiPriceServiceConnection(this.connectionURL, {
+            priceFeedRequestConfig: {
+                binary: true,
+            },
+        });
+        let pythObjectIds = uniqueTokens.map(token => this.consts.pythFeeder.feeder[token]);
+        // remove dupe object ids. If any of the object ids are duplicates the call will fail
+        pythObjectIds = [...new Set(pythObjectIds)].filter(Boolean);
+        const needUpdateObjectIds = (await this.provider.multiGetObjects({
+            ids: pythObjectIds,
+            options: {
+                showContent: true,
+            },
+        })).map(pythObject => [
+            Number.parseInt((pythObject.data?.content).fields.price_info.fields.arrival_time || 0, 10) - Date.now() / 1000,
+            pythObject.data?.objectId,
+        ]).filter((x) => Math.abs(x[0]) >= 0).map(x => x[1]);
+        if (needUpdateObjectIds.length === 0) {
+            return tx_;
+        }
+        const priceFeedIds = needUpdateObjectIds
+            .map(pythObjectId => this.PythFeederToPriceId[pythObjectId])
+            .filter(Boolean)
+            .map(x => `0x${x}`);
+        const priceUpdateData = await connection.getPriceFeedsUpdateData(priceFeedIds);
+        if (sponsoredTx) {
+            const baseUpdateFee = await this.getBaseUpdateFee();
+            const pythUpdateCoins = tx_.splitCoins(suiCoinObject, priceFeedIds.map(() => tx_.pure.u64(baseUpdateFee)));
+            await this.client.updatePriceFeedsWithCoins(tx_, priceUpdateData, priceFeedIds, pythUpdateCoins);
+        }
+        else {
+            await this.client.updatePriceFeeds(tx_, priceUpdateData, priceFeedIds);
+        }
+        return tx_;
+    }
+    async getBaseUpdateFee() {
+        return await this.client.getBaseUpdateFee();
+    }
+}
+//# sourceMappingURL=oracle.mjs.map

package/dist/oracle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.mjs","sourceRoot":"","sources":["../src/oracle.ts"],"names":[],"mappings":"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"}

package/dist/utils.cjs

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJsonRpcProvider = createJsonRpcProvider;
+exports.decimalToObject = decimalToObject;
+exports.rateToObject = rateToObject;
+exports.sRateToObject = sRateToObject;
+exports.sDecimalToObject = sDecimalToObject;
+exports.parseValue = parseValue;
+exports.reverseKeyValue = reverseKeyValue;
+exports.parseSymbolKey = parseSymbolKey;
+exports.upperFirstCharacter = upperFirstCharacter;
+exports.joinSymbol = joinSymbol;
+exports.suiSymbolToSymbol = suiSymbolToSymbol;
+exports.base64ToUint8Array = base64ToUint8Array;
+const client_1 = require("@mysten/sui/client");
+const consts_1 = require("./consts/index.cjs");
+function createJsonRpcProvider(network) {
+    let url = '';
+    switch (network) {
+        case consts_1.Network.DEVNET: {
+            url = 'https://explorer-rpc.devnet.sui.io/';
+            break;
+        }
+        case consts_1.Network.TESTNET: {
+            url = 'https://sui-testnet.blockvision.org/v1/2sXCJEJNOCdIJhLaDtyhKzqwn6k';
+            break;
+        }
+        case consts_1.Network.MAINNET: {
+            url = 'https://rpc-mainnet.suiscan.xyz';
+            break;
+        }
+        default: {
+            url = 'https://explorer-rpc.devnet.sui.io/';
+        }
+    }
+    return new client_1.SuiClient({
+        transport: new client_1.SuiHTTPTransport({ url }),
+    });
+}
+function decimalToObject(decimal) {
+    return Number(BigInt(decimal.value)) / 1e18;
+}
+function rateToObject(rate) {
+    return Number(BigInt(rate.value)) / 1e18;
+}
+function sRateToObject(sRate) {
+    const sign = sRate.fields.is_positive ? 1 : -1;
+    return Number(BigInt(sRate.fields.value.fields.value)) / 1e18 * sign;
+}
+function sDecimalToObject(sDecimal) {
+    const sign = sDecimal.fields.is_positive ? 1 : -1;
+    return Number(BigInt(sDecimal.fields.value.fields.value)) / 1e18 * sign;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function parseValue(field) {
+    if (field.type && field.type.endsWith('::decimal::Decimal')) {
+        return decimalToObject({ value: field.fields.value });
+    }
+    else if (field.type && field.type.endsWith('::rate::Rate')) {
+        return rateToObject({ value: field.fields.value });
+    }
+    else if (field.type && field.type.endsWith('::srate::SRate')) {
+        return sRateToObject(field);
+    }
+    else if (field.type && field.type.endsWith('::sdecimal::SDecimal')) {
+        return sDecimalToObject(field);
+    }
+    return Number.parseInt(field, 10);
+}
+function reverseKeyValue(obj) {
+    const reversed = {};
+    for (const key in obj) {
+        if (Object.hasOwn(obj, key)) {
+            const value = obj[key];
+            reversed[value] = key;
+        }
+    }
+    return reversed;
+}
+function parseSymbolKey(input) {
+    // This regex will match uppercase letters and numeric letters
+    const regex = /[A-Z0-9]/;
+    let result = [];
+    let wordStart = 0;
+    for (let i = 1; i < input.length; i += 1) {
+        if (regex.test(input[i])) {
+            // Found an uppercase letter, so we split the string here
+            result.push(input.slice(wordStart, i));
+            wordStart = i;
+        }
+    }
+    // Add the last word to the result array
+    result.push(input.slice(wordStart));
+    // Convert the words to lowercase, handle words ending with '_'
+    result = result.map(word => word.endsWith('_') ? word.slice(0, -1).toLowerCase() : word.toLowerCase());
+    return result;
+}
+function upperFirstCharacter(word) {
+    return word.charAt(0).toUpperCase() + word.slice(1);
+}
+function isLetter(char) {
+    return /^[a-z]$/i.test(char);
+}
+function joinSymbol(direction, token) {
+    const firstChar = token.charAt(0);
+    return `${direction}${isLetter(firstChar) ? upperFirstCharacter(token) : `_${token}`}`;
+}
+function suiSymbolToSymbol(symbol, consts) {
+    if (symbol === '0x2::sui::SUI') {
+        return 'sui';
+    }
+    const ret = {};
+    for (const key of Object.keys(consts.coins)) {
+        ret[consts.coins[key].module] = key;
+    }
+    return ret[symbol];
+}
+function base64ToUint8Array(base64) {
+    // Decode Base64 to binary
+    const binary = atob(base64);
+    // Create a Uint8Array from the binary data
+    const uint8Array = new Uint8Array(binary.length);
+    // Populate the Uint8Array with the binary data
+    for (let i = 0; i < binary.length; i += 1) {
+        uint8Array[i] = binary.codePointAt(i);
+    }
+    return uint8Array;
+}
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.cts

@@ -0,0 +1,44 @@
+import { SuiClient } from "@mysten/sui/client";
+import type { IConsts } from "./consts/index.cjs";
+import { Network } from "./consts/index.cjs";
+export declare function createJsonRpcProvider(network: Network): SuiClient;
+export declare function decimalToObject(decimal: {
+    value: string;
+}): number;
+export declare function rateToObject(rate: {
+    value: string;
+}): number;
+interface SRate {
+    fields: {
+        is_positive: boolean;
+        value: {
+            fields: {
+                value: string | number;
+            };
+        };
+    };
+}
+export declare function sRateToObject(sRate: SRate): number;
+interface SuiDecimal {
+    fields: {
+        is_positive: boolean;
+        value: {
+            fields: {
+                value: string;
+            };
+        };
+    };
+}
+export declare function sDecimalToObject(sDecimal: SuiDecimal): number;
+export declare function parseValue(field: any): number;
+export type ReversedKeyValue<T extends object> = {
+    [K in keyof T]: T[K] extends keyof T ? keyof T : T[K] extends keyof T | infer V ? V : never;
+};
+export declare function reverseKeyValue<T extends object>(obj: T): ReversedKeyValue<T>;
+export declare function parseSymbolKey(input: string): string[];
+export declare function upperFirstCharacter(word: string): string;
+export declare function joinSymbol(direction: string, token: string): string;
+export declare function suiSymbolToSymbol(symbol: string, consts: IConsts): string;
+export declare function base64ToUint8Array(base64: string): Uint8Array<ArrayBuffer>;
+export {};
+//# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,2BAA0B;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,2BAAgB;AACvC,OAAO,EAAE,OAAO,EAAE,2BAAgB;AAElC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,aAuBrD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,UAEzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,UAEnD;AAED,UAAU,KAAK;IACb,MAAM,EAAE;QACN,WAAW,EAAE,OAAO,CAAA;QACpB,KAAK,EAAE;YACL,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;aACvB,CAAA;SACF,CAAA;KACF,CAAA;CACF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,UAGzC;AAED,UAAU,UAAU;IAClB,MAAM,EAAE;QACN,WAAW,EAAE,OAAO,CAAA;QACpB,KAAK,EAAE;YACL,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM,CAAA;aACd,CAAA;SACF,CAAA;KACF,CAAA;CACF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,UAGpD;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAc7C;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI;KAC9C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAChC,MAAM,CAAC,GACP,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,GAC5B,CAAC,GACD,KAAK;CACZ,CAAA;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAW7E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBtD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAMD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CASzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,2BAYhD"}

package/dist/utils.d.mts

@@ -0,0 +1,44 @@
+import { SuiClient } from "@mysten/sui/client";
+import type { IConsts } from "./consts/index.mjs";
+import { Network } from "./consts/index.mjs";
+export declare function createJsonRpcProvider(network: Network): SuiClient;
+export declare function decimalToObject(decimal: {
+    value: string;
+}): number;
+export declare function rateToObject(rate: {
+    value: string;
+}): number;
+interface SRate {
+    fields: {
+        is_positive: boolean;
+        value: {
+            fields: {
+                value: string | number;
+            };
+        };
+    };
+}
+export declare function sRateToObject(sRate: SRate): number;
+interface SuiDecimal {
+    fields: {
+        is_positive: boolean;
+        value: {
+            fields: {
+                value: string;
+            };
+        };
+    };
+}
+export declare function sDecimalToObject(sDecimal: SuiDecimal): number;
+export declare function parseValue(field: any): number;
+export type ReversedKeyValue<T extends object> = {
+    [K in keyof T]: T[K] extends keyof T ? keyof T : T[K] extends keyof T | infer V ? V : never;
+};
+export declare function reverseKeyValue<T extends object>(obj: T): ReversedKeyValue<T>;
+export declare function parseSymbolKey(input: string): string[];
+export declare function upperFirstCharacter(word: string): string;
+export declare function joinSymbol(direction: string, token: string): string;
+export declare function suiSymbolToSymbol(symbol: string, consts: IConsts): string;
+export declare function base64ToUint8Array(base64: string): Uint8Array<ArrayBuffer>;
+export {};
+//# sourceMappingURL=utils.d.mts.map

package/dist/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,2BAA0B;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,2BAAgB;AACvC,OAAO,EAAE,OAAO,EAAE,2BAAgB;AAElC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,aAuBrD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,UAEzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,UAEnD;AAED,UAAU,KAAK;IACb,MAAM,EAAE;QACN,WAAW,EAAE,OAAO,CAAA;QACpB,KAAK,EAAE;YACL,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;aACvB,CAAA;SACF,CAAA;KACF,CAAA;CACF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,UAGzC;AAED,UAAU,UAAU;IAClB,MAAM,EAAE;QACN,WAAW,EAAE,OAAO,CAAA;QACpB,KAAK,EAAE;YACL,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM,CAAA;aACd,CAAA;SACF,CAAA;KACF,CAAA;CACF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,UAGpD;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAc7C;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI;KAC9C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAChC,MAAM,CAAC,GACP,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,GAC5B,CAAC,GACD,KAAK;CACZ,CAAA;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAW7E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBtD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAMD,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CASzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,2BAYhD"}

package/dist/utils.mjs

@@ -0,0 +1,115 @@
+import { SuiClient, SuiHTTPTransport } from "@mysten/sui/client";
+import { Network } from "./consts/index.mjs";
+export function createJsonRpcProvider(network) {
+    let url = '';
+    switch (network) {
+        case Network.DEVNET: {
+            url = 'https://explorer-rpc.devnet.sui.io/';
+            break;
+        }
+        case Network.TESTNET: {
+            url = 'https://sui-testnet.blockvision.org/v1/2sXCJEJNOCdIJhLaDtyhKzqwn6k';
+            break;
+        }
+        case Network.MAINNET: {
+            url = 'https://rpc-mainnet.suiscan.xyz';
+            break;
+        }
+        default: {
+            url = 'https://explorer-rpc.devnet.sui.io/';
+        }
+    }
+    return new SuiClient({
+        transport: new SuiHTTPTransport({ url }),
+    });
+}
+export function decimalToObject(decimal) {
+    return Number(BigInt(decimal.value)) / 1e18;
+}
+export function rateToObject(rate) {
+    return Number(BigInt(rate.value)) / 1e18;
+}
+export function sRateToObject(sRate) {
+    const sign = sRate.fields.is_positive ? 1 : -1;
+    return Number(BigInt(sRate.fields.value.fields.value)) / 1e18 * sign;
+}
+export function sDecimalToObject(sDecimal) {
+    const sign = sDecimal.fields.is_positive ? 1 : -1;
+    return Number(BigInt(sDecimal.fields.value.fields.value)) / 1e18 * sign;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function parseValue(field) {
+    if (field.type && field.type.endsWith('::decimal::Decimal')) {
+        return decimalToObject({ value: field.fields.value });
+    }
+    else if (field.type && field.type.endsWith('::rate::Rate')) {
+        return rateToObject({ value: field.fields.value });
+    }
+    else if (field.type && field.type.endsWith('::srate::SRate')) {
+        return sRateToObject(field);
+    }
+    else if (field.type && field.type.endsWith('::sdecimal::SDecimal')) {
+        return sDecimalToObject(field);
+    }
+    return Number.parseInt(field, 10);
+}
+export function reverseKeyValue(obj) {
+    const reversed = {};
+    for (const key in obj) {
+        if (Object.hasOwn(obj, key)) {
+            const value = obj[key];
+            reversed[value] = key;
+        }
+    }
+    return reversed;
+}
+export function parseSymbolKey(input) {
+    // This regex will match uppercase letters and numeric letters
+    const regex = /[A-Z0-9]/;
+    let result = [];
+    let wordStart = 0;
+    for (let i = 1; i < input.length; i += 1) {
+        if (regex.test(input[i])) {
+            // Found an uppercase letter, so we split the string here
+            result.push(input.slice(wordStart, i));
+            wordStart = i;
+        }
+    }
+    // Add the last word to the result array
+    result.push(input.slice(wordStart));
+    // Convert the words to lowercase, handle words ending with '_'
+    result = result.map(word => word.endsWith('_') ? word.slice(0, -1).toLowerCase() : word.toLowerCase());
+    return result;
+}
+export function upperFirstCharacter(word) {
+    return word.charAt(0).toUpperCase() + word.slice(1);
+}
+function isLetter(char) {
+    return /^[a-z]$/i.test(char);
+}
+export function joinSymbol(direction, token) {
+    const firstChar = token.charAt(0);
+    return `${direction}${isLetter(firstChar) ? upperFirstCharacter(token) : `_${token}`}`;
+}
+export function suiSymbolToSymbol(symbol, consts) {
+    if (symbol === '0x2::sui::SUI') {
+        return 'sui';
+    }
+    const ret = {};
+    for (const key of Object.keys(consts.coins)) {
+        ret[consts.coins[key].module] = key;
+    }
+    return ret[symbol];
+}
+export function base64ToUint8Array(base64) {
+    // Decode Base64 to binary
+    const binary = atob(base64);
+    // Create a Uint8Array from the binary data
+    const uint8Array = new Uint8Array(binary.length);
+    // Populate the Uint8Array with the binary data
+    for (let i = 0; i < binary.length; i += 1) {
+        uint8Array[i] = binary.codePointAt(i);
+    }
+    return uint8Array;
+}
+//# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/docs/SUMMARY.md

@@ -0,0 +1,10 @@
+# Summary
+
+* [Introduction](introduction.md)
+* [Architecture](architecture.md)
+* [Getting Started](getting-started.md)
+* [Common Operations](common-operations.md)
+* [Trading Examples](lp-specific-features.md)
+* [Type Safety](type-safety.md)
+* [Error Handling](error-handling.md)
+* [API Reference](api-reference.md)

package/docs/api-reference.md

@@ -0,0 +1,32 @@
+# API Reference
+
+## Factory methods
+
+**API (full – transactions + data):**
+
+- `SDK.createZLPAPI(network, provider, apiEndpoint, connectionURL)`
+- `SDK.createSLPAPI(network, provider, apiEndpoint, connectionURL)`
+- `SDK.createUSDZAPI(network, provider, apiEndpoint, connectionURL)`
+- `SDK.createAPI(LPToken, network, provider, apiEndpoint, connectionURL)`
+
+**DataAPI (read-only):**
+
+- `SDK.createZLPDataAPI(network, provider, apiEndpoint, connectionURL)`
+- `SDK.createSLPDataAPI(network, provider, apiEndpoint, connectionURL)`
+- `SDK.createUSDZDataAPI(network, provider, apiEndpoint, connectionURL)`
+- `SDK.createDataAPI(LPToken, network, provider, apiEndpoint, connectionURL)`
+
+## Interfaces
+
+- **Base**: `IBaseAPI`, `IBaseDataAPI` for common operations
+- **LP-specific**: `IZLPAPI`, `ISLPAPI`, `IUSDZAPI` for typed usage
+- **Data types**: `IBaseMarketValuationInfo`, `IBaseVaultInfo`, `IBaseSymbolInfo`, `IBasePositionInfo`, `IBaseOrderInfo`, etc.
+
+## Source code
+
+- **Interfaces**: `src/interfaces/` – TypeScript interface definitions
+- **Implementations**: `src/implementations/` – Concrete API implementations
+- **Abstract classes**: `src/abstract/` – Shared base functionality
+- **Factory**: `src/factory/SDKFactory.ts` – SDK instance creation
+
+See the type definitions and source for detailed method signatures and parameters.

package/docs/architecture.md

@@ -0,0 +1,14 @@
+# Architecture
+
+The SDK supports multiple LP tokens through a unified interface:
+
+- **ZLP (ZO Liquidity Provider)**: Original ZO Protocol LP token
+- **SLP (Sudo Liquidity Provider)**: Sudo SDK-based LP token
+- **USDZ (USD Stablecoin)**: Stablecoin LP token
+
+## Key Components
+
+1. **Common Interfaces**: Unified API surface for all LP tokens (`IBaseAPI`, `IBaseDataAPI`)
+2. **Abstract Base Classes**: Shared logic with delegation to DataAPI (`BaseAPI`, `BaseDataAPI`)
+3. **Concrete Implementations**: LP-specific functionality (`ZLPAPI`, `SLPAPI`, `USDZAPI`)
+4. **Factory Pattern**: Type-safe instance creation via `SDK` (e.g. `SDK.createZLPAPI()`)

package/docs/common-operations.md

@@ -0,0 +1,52 @@
+# Common Operations
+
+These operations work across all LP tokens (ZLP, SLP, USDZ).
+
+## Data / read operations
+
+Use the API or DataAPI; the methods are the same.
+
+```typescript
+const zlpMarket = await zlpAPI.valuateMarket()
+const slpMarket = await slpAPI.getMarketInfo()
+const vaultInfo = await usdzAPI.getVaultInfo('usdc')
+const positionCaps = await zlpAPI.getPositionCapInfoList(ownerAddress)
+const positions = await zlpAPI.getPositionInfoList(positionCaps, ownerAddress)
+```
+
+## Deposit
+
+```typescript
+const depositTx = await zlpAPI.deposit(
+  'usdc',             // coin type
+  ['coinObjectId'],   // coin object IDs
+  1000000,            // amount
+  0,                  // minimum amount out (optional)
+  'referralAddress',  // optional referral
+  'senderAddress'     // optional sender
+)
+const slpDepositTx = await slpAPI.deposit('usdc', ['coinObjectId'], 1000000)
+const usdzDepositTx = await usdzAPI.deposit('usdc', ['coinObjectId'], 1000000)
+```
+
+## Withdraw
+
+```typescript
+const withdrawTx = await zlpAPI.withdraw(
+  'usdc',
+  ['lpCoinObjectId'],
+  1000000,
+  0
+)
+```
+
+## Swap
+
+```typescript
+const swapTx = await zlpAPI.swap(
+  'usdc',             // from token
+  'sui',              // to token
+  BigInt(1000000),    // amount
+  ['coinObjectId']    // coin objects
+)
+```

package/docs/error-handling.md

@@ -0,0 +1,17 @@
+# Error Handling
+
+The SDK throws errors for invalid operations and network issues. Always wrap API calls in try-catch blocks:
+
+```typescript
+const zlpAPI = SDK.createZLPAPI(network, provider, apiEndpoint, connectionURL)
+
+try {
+  const marketInfo = await zlpAPI.getMarketInfo()
+  const depositTx = await zlpAPI.deposit('usdc', ['coinId'], 1000000)
+} catch (error) {
+  console.error('SDK operation failed:', error)
+  if (error.message.includes('Unsupported LP token')) {
+    console.error('Invalid LP token type provided')
+  }
+}
+```