extended-typescript-sdk 0.0.1

package/dist/perpetual/user-client/user-client.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * User client for onboarding and account management
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserClient = void 0;
+const ethers_1 = require("ethers");
+const accounts_1 = require("../accounts");
+const errors_1 = require("../../errors");
+const http_1 = require("../../utils/http");
+const date_1 = require("../../utils/date");
+const onboarding_1 = require("./onboarding");
+const L1_AUTH_SIGNATURE_HEADER = 'L1_SIGNATURE';
+const L1_MESSAGE_TIME_HEADER = 'L1_MESSAGE_TIME';
+const ACTIVE_ACCOUNT_HEADER = 'X-X10-ACTIVE-ACCOUNT';
+/**
+ * User client for onboarding and L1 account operations
+ */
+class UserClient {
+    endpointConfig;
+    l1PrivateKey;
+    constructor(endpointConfig, l1PrivateKey) {
+        this.endpointConfig = endpointConfig;
+        this.l1PrivateKey = l1PrivateKey;
+    }
+    /**
+     * Get URL
+     */
+    getUrl(baseUrl, path, options = {}) {
+        return (0, http_1.getUrl)(`${baseUrl}${path}`, options);
+    }
+    /**
+     * Onboard new account
+     */
+    async onboard(referralCode) {
+        const wallet = new ethers_1.ethers.Wallet(this.l1PrivateKey());
+        const keyPair = await (0, onboarding_1.getL2KeysFromL1Account)(this.l1PrivateKey(), 0, this.endpointConfig.signingDomain);
+        const payload = await (0, onboarding_1.getOnboardingPayload)(this.l1PrivateKey(), this.endpointConfig.signingDomain, keyPair, this.endpointConfig.onboardingUrl, referralCode);
+        const url = this.getUrl(this.endpointConfig.onboardingUrl, '/auth/onboard');
+        const onboardingResponse = await (0, http_1.sendPostRequest)(url, payload.toJson());
+        const onboardedClient = onboardingResponse.data;
+        if (!onboardedClient) {
+            throw new Error('No account data returned from onboarding');
+        }
+        return {
+            account: onboardedClient.defaultAccount,
+            l2KeyPair: keyPair,
+        };
+    }
+    /**
+     * Onboard sub-account
+     */
+    async onboardSubaccount(accountIndex, description) {
+        const requestPath = '/auth/onboard/subaccount';
+        const finalDescription = description || `Subaccount ${accountIndex}`;
+        const wallet = new ethers_1.ethers.Wallet(this.l1PrivateKey());
+        const time = (0, date_1.utcNow)();
+        const authTimeString = time.toISOString().replace(/\.\d{3}Z$/, 'Z');
+        const l1Message = `${requestPath}@${authTimeString}`;
+        // Sign with ethers
+        const l1Signature = await wallet.signMessage(l1Message);
+        const keyPair = await (0, onboarding_1.getL2KeysFromL1Account)(this.l1PrivateKey(), accountIndex, this.endpointConfig.signingDomain);
+        const payload = await (0, onboarding_1.getSubAccountCreationPayload)(accountIndex, wallet.address, keyPair, finalDescription, this.endpointConfig.onboardingUrl);
+        const headers = {
+            [L1_AUTH_SIGNATURE_HEADER]: l1Signature,
+            [L1_MESSAGE_TIME_HEADER]: authTimeString,
+        };
+        const url = this.getUrl(this.endpointConfig.onboardingUrl, requestPath);
+        try {
+            const onboardingResponse = await (0, http_1.sendPostRequest)(url, payload.toJson(), undefined, headers, new Map([[409, errors_1.SubAccountExists]]));
+            const onboardedAccount = onboardingResponse.data;
+            if (!onboardedAccount) {
+                throw new Error('No account data returned from onboarding');
+            }
+            return {
+                account: onboardedAccount,
+                l2KeyPair: keyPair,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.SubAccountExists) {
+                const clientAccounts = await this.getAccounts();
+                const accountWithIndex = clientAccounts.find((acc) => acc.account.accountIndex === accountIndex);
+                if (!accountWithIndex) {
+                    throw new errors_1.SubAccountExists('Subaccount already exists but not found in client accounts');
+                }
+                return accountWithIndex;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get all accounts
+     */
+    async getAccounts() {
+        const requestPath = '/api/v1/user/accounts';
+        const wallet = new ethers_1.ethers.Wallet(this.l1PrivateKey());
+        const time = (0, date_1.utcNow)();
+        const authTimeString = time.toISOString().replace(/\.\d{3}Z$/, 'Z');
+        const l1Message = `${requestPath}@${authTimeString}`;
+        const l1Signature = await wallet.signMessage(l1Message);
+        const headers = {
+            [L1_AUTH_SIGNATURE_HEADER]: l1Signature,
+            [L1_MESSAGE_TIME_HEADER]: authTimeString,
+        };
+        const url = this.getUrl(this.endpointConfig.onboardingUrl, requestPath);
+        const response = await (0, http_1.sendGetRequest)(url, undefined, headers);
+        const accounts = response.data || [];
+        const result = [];
+        for (const account of accounts) {
+            const keyPair = await (0, onboarding_1.getL2KeysFromL1Account)(this.l1PrivateKey(), account.accountIndex, this.endpointConfig.signingDomain);
+            result.push({
+                account,
+                l2KeyPair: keyPair,
+            });
+        }
+        return result;
+    }
+    /**
+     * Create account API key
+     */
+    async createAccountApiKey(account, description) {
+        const requestPath = '/api/v1/user/account/api-key';
+        const finalDescription = description || `trading api key for account ${account.id}`;
+        const wallet = new ethers_1.ethers.Wallet(this.l1PrivateKey());
+        const time = (0, date_1.utcNow)();
+        const authTimeString = time.toISOString().replace(/\.\d{3}Z$/, 'Z');
+        const l1Message = `${requestPath}@${authTimeString}`;
+        const l1Signature = await wallet.signMessage(l1Message);
+        const headers = {
+            [L1_AUTH_SIGNATURE_HEADER]: l1Signature,
+            [L1_MESSAGE_TIME_HEADER]: authTimeString,
+            [ACTIVE_ACCOUNT_HEADER]: account.id.toString(),
+        };
+        const url = this.getUrl(this.endpointConfig.onboardingUrl, requestPath);
+        const request = new accounts_1.ApiKeyRequestModel(finalDescription);
+        const response = await (0, http_1.sendPostRequest)(url, request.toApiRequestJson(), undefined, headers);
+        const responseData = response.data;
+        if (!responseData) {
+            throw new Error('No API key data returned from onboarding');
+        }
+        return responseData.key;
+    }
+    /**
+     * Delete account API key
+     * https://api.docs.extended.exchange/#delete-api-key
+     */
+    async deleteAccountApiKey(account, apiKeyId) {
+        const requestPath = `/api/v1/user/account/api-key/${apiKeyId}`;
+        const wallet = new ethers_1.ethers.Wallet(this.l1PrivateKey());
+        const time = (0, date_1.utcNow)();
+        const authTimeString = time.toISOString().replace(/\.\d{3}Z$/, 'Z');
+        const l1Message = `${requestPath}@${authTimeString}`;
+        const l1Signature = await wallet.signMessage(l1Message);
+        const headers = {
+            [L1_AUTH_SIGNATURE_HEADER]: l1Signature,
+            [L1_MESSAGE_TIME_HEADER]: authTimeString,
+            [ACTIVE_ACCOUNT_HEADER]: account.id.toString(),
+        };
+        const url = this.getUrl(this.endpointConfig.onboardingUrl, requestPath);
+        await (0, http_1.sendDeleteRequest)(url, undefined, headers);
+    }
+    /**
+     * Get list of account API keys
+     * https://api.docs.extended.exchange/#get-api-keys
+     */
+    async getAccountApiKeys(account) {
+        const requestPath = '/api/v1/user/account/api-key';
+        const wallet = new ethers_1.ethers.Wallet(this.l1PrivateKey());
+        const time = (0, date_1.utcNow)();
+        const authTimeString = time.toISOString().replace(/\.\d{3}Z$/, 'Z');
+        const l1Message = `${requestPath}@${authTimeString}`;
+        const l1Signature = await wallet.signMessage(l1Message);
+        const headers = {
+            [L1_AUTH_SIGNATURE_HEADER]: l1Signature,
+            [L1_MESSAGE_TIME_HEADER]: authTimeString,
+            [ACTIVE_ACCOUNT_HEADER]: account.id.toString(),
+        };
+        const url = this.getUrl(this.endpointConfig.onboardingUrl, requestPath);
+        const response = await (0, http_1.sendGetRequest)(url, undefined, headers);
+        return response.data || [];
+    }
+}
+exports.UserClient = UserClient;
+//# sourceMappingURL=user-client.js.map

package/dist/perpetual/user-client/user-client.js.map

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

package/dist/perpetual/withdrawal-object.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Withdrawal object creation
+ */
+import Decimal from 'decimal.js';
+import { EndpointConfig } from './configuration';
+import { StarkPerpetualAccount } from './accounts';
+import { WithdrawalRequest } from './withdrawals';
+/**
+ * Create withdrawal object
+ */
+export declare function createWithdrawalObject(amount: Decimal, recipientStarkAddress: string, starkAccount: StarkPerpetualAccount, config: EndpointConfig, accountId: number, chainId: string, description?: string, nonce?: number, quoteId?: string): WithdrawalRequest;
+//# sourceMappingURL=withdrawal-object.d.ts.map

package/dist/perpetual/withdrawal-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawal-object.d.ts","sourceRoot":"","sources":["../../src/perpetual/withdrawal-object.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAwC,MAAM,eAAe,CAAC;AAexF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,qBAAqB,EAAE,MAAM,EAC7B,YAAY,EAAE,qBAAqB,EACnC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,iBAAiB,CA+CnB"}

package/dist/perpetual/withdrawal-object.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Withdrawal object creation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWithdrawalObject = createWithdrawalObject;
+const withdrawals_1 = require("./withdrawals");
+const model_1 = require("../utils/model");
+const signer_1 = require("./crypto/signer");
+const nonce_1 = require("../utils/nonce");
+const date_1 = require("../utils/date");
+/**
+ * Calculate expiration timestamp (15 days from now)
+ */
+function calcExpirationTimestamp() {
+    const expireTime = new Date((0, date_1.utcNow)());
+    expireTime.setDate(expireTime.getDate() + 15);
+    return Math.ceil(expireTime.getTime() / 1000);
+}
+/**
+ * Create withdrawal object
+ */
+function createWithdrawalObject(amount, recipientStarkAddress, starkAccount, config, accountId, chainId, description, nonce, quoteId) {
+    const expirationTimestamp = calcExpirationTimestamp();
+    // Scale amount by decimals
+    const scaledAmount = amount.mul(Math.pow(10, config.collateralDecimals));
+    const starkAmount = Math.round(scaledAmount.toNumber());
+    const starknetDomain = config.starknetDomain;
+    const finalNonce = nonce || (0, nonce_1.generateNonce)();
+    const withdrawalHash = (0, signer_1.getWithdrawalMsgHash)({
+        recipientHex: recipientStarkAddress.startsWith('0x')
+            ? recipientStarkAddress
+            : '0x' + recipientStarkAddress,
+        positionId: starkAccount.getVault(),
+        amount: starkAmount.toString(),
+        expiration: expirationTimestamp,
+        salt: finalNonce.toString(),
+        userPublicKey: '0x' + starkAccount.getPublicKey().toString(16),
+        domainName: starknetDomain.name,
+        domainVersion: starknetDomain.version,
+        domainChainId: starknetDomain.chainId,
+        domainRevision: starknetDomain.revision,
+        collateralId: config.collateralAssetOnChainId,
+    });
+    const [transferSignatureR, transferSignatureS] = starkAccount.sign(withdrawalHash);
+    const settlement = new withdrawals_1.StarkWithdrawalSettlement(recipientStarkAddress.startsWith('0x') ? recipientStarkAddress : `0x${recipientStarkAddress}`, // Hex string
+    starkAccount.getVault(), config.collateralAssetOnChainId, // Already a hex string
+    starkAmount, new withdrawals_1.Timestamp(expirationTimestamp), finalNonce, new model_1.SettlementSignatureModel(transferSignatureR, transferSignatureS));
+    return new withdrawals_1.WithdrawalRequest(accountId, amount, settlement, chainId, 'USD', description, quoteId);
+}
+//# sourceMappingURL=withdrawal-object.js.map

package/dist/perpetual/withdrawal-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawal-object.js","sourceRoot":"","sources":["../../src/perpetual/withdrawal-object.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAuBH,wDAyDC;AA3ED,+CAAwF;AACxF,0CAA0D;AAC1D,4CAAuD;AACvD,0CAA+C;AAC/C,wCAAuC;AAEvC;;GAEG;AACH,SAAS,uBAAuB;IAC9B,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAA,aAAM,GAAE,CAAC,CAAC;IACtC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CACpC,MAAe,EACf,qBAA6B,EAC7B,YAAmC,EACnC,MAAsB,EACtB,SAAiB,EACjB,OAAe,EACf,WAAoB,EACpB,KAAc,EACd,OAAgB;IAEhB,MAAM,mBAAmB,GAAG,uBAAuB,EAAE,CAAC;IAEtD,2BAA2B;IAC3B,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IAExD,MAAM,cAAc,GAAmB,MAAM,CAAC,cAAc,CAAC;IAC7D,MAAM,UAAU,GAAG,KAAK,IAAI,IAAA,qBAAa,GAAE,CAAC;IAE5C,MAAM,cAAc,GAAG,IAAA,6BAAoB,EAAC;QAC1C,YAAY,EAAE,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC;YAClD,CAAC,CAAC,qBAAqB;YACvB,CAAC,CAAC,IAAI,GAAG,qBAAqB;QAChC,UAAU,EAAE,YAAY,CAAC,QAAQ,EAAE;QACnC,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE;QAC9B,UAAU,EAAE,mBAAmB;QAC/B,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;QAC3B,aAAa,EAAE,IAAI,GAAG,YAAY,CAAC,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,UAAU,EAAE,cAAc,CAAC,IAAI;QAC/B,aAAa,EAAE,cAAc,CAAC,OAAO;QACrC,aAAa,EAAE,cAAc,CAAC,OAAO;QACrC,cAAc,EAAE,cAAc,CAAC,QAAQ;QACvC,YAAY,EAAE,MAAM,CAAC,wBAAwB;KAC9C,CAAC,CAAC;IAEH,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAEnF,MAAM,UAAU,GAAG,IAAI,uCAAyB,CAC9C,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,qBAAqB,EAAE,EAAE,aAAa;IAC5G,YAAY,CAAC,QAAQ,EAAE,EACvB,MAAM,CAAC,wBAAwB,EAAE,uBAAuB;IACxD,WAAW,EACX,IAAI,uBAAS,CAAC,mBAAmB,CAAC,EAClC,UAAU,EACV,IAAI,gCAAwB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CACrE,CAAC;IAEF,OAAO,IAAI,+BAAiB,CAC1B,SAAS,EACT,MAAM,EACN,UAAU,EACV,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/perpetual/withdrawals.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Withdrawal models
+ */
+import Decimal from 'decimal.js';
+import { X10BaseModel, HexValue } from '../utils/model';
+import { SettlementSignatureModel } from '../utils/model';
+/**
+ * Timestamp model
+ */
+export declare class Timestamp extends X10BaseModel {
+    seconds: number;
+    constructor(seconds: number);
+}
+/**
+ * Stark withdrawal settlement
+ */
+export declare class StarkWithdrawalSettlement extends X10BaseModel {
+    recipient: HexValue;
+    positionId: number;
+    collateralId: HexValue;
+    amount: number;
+    expiration: Timestamp;
+    salt: number;
+    signature: SettlementSignatureModel;
+    constructor(recipient: HexValue, positionId: number, collateralId: HexValue, amount: number, expiration: Timestamp, salt: number, signature: SettlementSignatureModel);
+}
+/**
+ * Withdrawal request model
+ */
+export declare class WithdrawalRequest extends X10BaseModel {
+    accountId: number;
+    amount: Decimal;
+    description?: string;
+    settlement: StarkWithdrawalSettlement;
+    chainId: string;
+    quoteId?: string;
+    asset: string;
+    constructor(accountId: number, amount: Decimal, settlement: StarkWithdrawalSettlement, chainId: string, asset: string, description?: string, quoteId?: string);
+}
+//# sourceMappingURL=withdrawals.d.ts.map

package/dist/perpetual/withdrawals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawals.d.ts","sourceRoot":"","sources":["../../src/perpetual/withdrawals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,EAAE,MAAM,CAAC;gBAEJ,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;IACzD,SAAS,EAAE,QAAQ,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,QAAQ,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,wBAAwB,CAAC;gBAGlC,SAAS,EAAE,QAAQ,EACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,QAAQ,EACtB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,EACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,wBAAwB;CAWtC;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,yBAAyB,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;gBAGZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,yBAAyB,EACrC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM;CAWnB"}

package/dist/perpetual/withdrawals.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Withdrawal models
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WithdrawalRequest = exports.StarkWithdrawalSettlement = exports.Timestamp = void 0;
+const model_1 = require("../utils/model");
+/**
+ * Timestamp model
+ */
+class Timestamp extends model_1.X10BaseModel {
+    seconds;
+    constructor(seconds) {
+        super();
+        this.seconds = seconds;
+    }
+}
+exports.Timestamp = Timestamp;
+/**
+ * Stark withdrawal settlement
+ */
+class StarkWithdrawalSettlement extends model_1.X10BaseModel {
+    recipient;
+    positionId;
+    collateralId;
+    amount;
+    expiration;
+    salt;
+    signature;
+    constructor(recipient, positionId, collateralId, amount, expiration, salt, signature) {
+        super();
+        this.recipient = recipient;
+        this.positionId = positionId;
+        this.collateralId = collateralId;
+        this.amount = amount;
+        this.expiration = expiration;
+        this.salt = salt;
+        this.signature = signature;
+    }
+}
+exports.StarkWithdrawalSettlement = StarkWithdrawalSettlement;
+/**
+ * Withdrawal request model
+ */
+class WithdrawalRequest extends model_1.X10BaseModel {
+    accountId;
+    amount;
+    description;
+    settlement;
+    chainId;
+    quoteId;
+    asset;
+    constructor(accountId, amount, settlement, chainId, asset, description, quoteId) {
+        super();
+        this.accountId = accountId;
+        this.amount = amount;
+        this.description = description;
+        this.settlement = settlement;
+        this.chainId = chainId;
+        this.quoteId = quoteId;
+        this.asset = asset;
+    }
+}
+exports.WithdrawalRequest = WithdrawalRequest;
+//# sourceMappingURL=withdrawals.js.map

package/dist/perpetual/withdrawals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withdrawals.js","sourceRoot":"","sources":["../../src/perpetual/withdrawals.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,0CAAwD;AAGxD;;GAEG;AACH,MAAa,SAAU,SAAQ,oBAAY;IACzC,OAAO,CAAS;IAEhB,YAAY,OAAe;QACzB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAPD,8BAOC;AAED;;GAEG;AACH,MAAa,yBAA0B,SAAQ,oBAAY;IACzD,SAAS,CAAW;IACpB,UAAU,CAAS;IACnB,YAAY,CAAW;IACvB,MAAM,CAAS;IACf,UAAU,CAAY;IACtB,IAAI,CAAS;IACb,SAAS,CAA2B;IAEpC,YACE,SAAmB,EACnB,UAAkB,EAClB,YAAsB,EACtB,MAAc,EACd,UAAqB,EACrB,IAAY,EACZ,SAAmC;QAEnC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AA3BD,8DA2BC;AAED;;GAEG;AACH,MAAa,iBAAkB,SAAQ,oBAAY;IACjD,SAAS,CAAS;IAClB,MAAM,CAAU;IAChB,WAAW,CAAU;IACrB,UAAU,CAA4B;IACtC,OAAO,CAAS;IAChB,OAAO,CAAU;IACjB,KAAK,CAAS;IAEd,YACE,SAAiB,EACjB,MAAe,EACf,UAAqC,EACrC,OAAe,EACf,KAAa,EACb,WAAoB,EACpB,OAAgB;QAEhB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AA3BD,8CA2BC"}

package/dist/utils/date.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Date and time utility functions
+ */
+/**
+ * Get current UTC datetime
+ */
+export declare function utcNow(): Date;
+/**
+ * Convert Date to epoch milliseconds
+ * Uses Math.ceil to ensure consistent rounding behavior
+ */
+export declare function toEpochMillis(value: Date): number;
+//# sourceMappingURL=date.d.ts.map

package/dist/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,MAAM,IAAI,IAAI,CAE7B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAEjD"}

package/dist/utils/date.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Date and time utility functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.utcNow = utcNow;
+exports.toEpochMillis = toEpochMillis;
+/**
+ * Get current UTC datetime
+ */
+function utcNow() {
+    return new Date();
+}
+/**
+ * Convert Date to epoch milliseconds
+ * Uses Math.ceil to ensure consistent rounding behavior
+ */
+function toEpochMillis(value) {
+    return Math.ceil(value.getTime());
+}
+//# sourceMappingURL=date.js.map

package/dist/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAKH,wBAEC;AAMD,sCAEC;AAbD;;GAEG;AACH,SAAgB,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,KAAW;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/utils/env.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Environment variable utilities
+ */
+/**
+ * Get environment variable or throw error
+ */
+export declare function getEnv(name: string): string;
+/**
+ * Get environment variable or return default
+ */
+export declare function getEnvOptional(name: string, defaultValue?: string): string | undefined;
+/**
+ * Get environment variable as number
+ */
+export declare function getEnvNumber(name: string): number;
+/**
+ * Get environment variable as number or return default
+ */
+export declare function getEnvNumberOptional(name: string, defaultValue?: number): number | undefined;
+/**
+ * Get environment variable as boolean
+ */
+export declare function getEnvBoolean(name: string): boolean;
+/**
+ * Get environment variable as boolean or return default
+ */
+export declare function getEnvBooleanOptional(name: string, defaultValue?: boolean): boolean | undefined;
+/**
+ * Load environment variables from .env.local (if exists)
+ * Note: This requires dotenv package
+ */
+export declare function loadEnv(): void;
+/**
+ * X10 SDK environment configuration
+ */
+export interface X10EnvConfig {
+    apiKey: string;
+    publicKey: string;
+    privateKey: string;
+    vaultId: number;
+    builderId?: number;
+    l1PrivateKey?: string;
+    environment?: 'testnet' | 'mainnet';
+}
+/**
+ * Get X10 SDK environment configuration
+ * Supports both X10_* and alternative naming conventions
+ */
+export declare function getX10EnvConfig(requirePrivateApi?: boolean): X10EnvConfig;
+//# sourceMappingURL=env.d.ts.map

package/dist/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU5F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAO/F;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,IAAI,CA6B9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,iBAAiB,GAAE,OAAc,GAAG,YAAY,CAiD/E"}

package/dist/utils/env.js

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * Environment variable utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnv = getEnv;
+exports.getEnvOptional = getEnvOptional;
+exports.getEnvNumber = getEnvNumber;
+exports.getEnvNumberOptional = getEnvNumberOptional;
+exports.getEnvBoolean = getEnvBoolean;
+exports.getEnvBooleanOptional = getEnvBooleanOptional;
+exports.loadEnv = loadEnv;
+exports.getX10EnvConfig = getX10EnvConfig;
+/**
+ * Get environment variable or throw error
+ */
+function getEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`${name} is not set in environment variables`);
+    }
+    return value;
+}
+/**
+ * Get environment variable or return default
+ */
+function getEnvOptional(name, defaultValue) {
+    return process.env[name] || defaultValue;
+}
+/**
+ * Get environment variable as number
+ */
+function getEnvNumber(name) {
+    const value = getEnv(name);
+    const num = parseInt(value, 10);
+    if (isNaN(num)) {
+        throw new Error(`${name} must be a valid number, got: ${value}`);
+    }
+    return num;
+}
+/**
+ * Get environment variable as number or return default
+ */
+function getEnvNumberOptional(name, defaultValue) {
+    const value = process.env[name];
+    if (!value) {
+        return defaultValue;
+    }
+    const num = parseInt(value, 10);
+    if (isNaN(num)) {
+        throw new Error(`${name} must be a valid number, got: ${value}`);
+    }
+    return num;
+}
+/**
+ * Get environment variable as boolean
+ */
+function getEnvBoolean(name) {
+    const value = getEnv(name).toLowerCase();
+    return value === 'true' || value === '1' || value === 'yes';
+}
+/**
+ * Get environment variable as boolean or return default
+ */
+function getEnvBooleanOptional(name, defaultValue) {
+    const value = process.env[name];
+    if (!value) {
+        return defaultValue;
+    }
+    const lowerValue = value.toLowerCase();
+    return lowerValue === 'true' || lowerValue === '1' || lowerValue === 'yes';
+}
+/**
+ * Load environment variables from .env.local (if exists)
+ * Note: This requires dotenv package
+ */
+function loadEnv() {
+    try {
+        // Try to load dotenv if available
+        const dotenv = require('dotenv');
+        const path = require('path');
+        const fs = require('fs');
+        // Try multiple paths
+        const possiblePaths = [
+            path.join(process.cwd(), '.env.local'),
+            path.join(process.cwd(), '.env'),
+            path.join(__dirname, '../../.env.local'),
+            path.join(__dirname, '../../.env'),
+        ];
+        for (const envPath of possiblePaths) {
+            if (fs.existsSync(envPath)) {
+                const result = dotenv.config({ path: envPath });
+                if (!result.error) {
+                    break; // Successfully loaded
+                }
+            }
+        }
+        // Also try default dotenv.config() which looks in current working directory
+        dotenv.config();
+    }
+    catch (error) {
+        // dotenv not installed, skip
+    }
+}
+/**
+ * Get X10 SDK environment configuration
+ * Supports both X10_* and alternative naming conventions
+ */
+function getX10EnvConfig(requirePrivateApi = true) {
+    loadEnv();
+    // Support both X10_* and alternative naming conventions
+    const apiKey = process.env.X10_API_KEY || process.env.API_KEY;
+    const publicKey = process.env.X10_PUBLIC_KEY || process.env.X10_Stark_Key_Public || process.env.Stark_Key_Public;
+    const privateKey = process.env.X10_PRIVATE_KEY || process.env.X10_Stark_Key_Private || process.env.Stark_Key_Private;
+    const vaultId = process.env.X10_VAULT_ID || process.env.X10_Vault_Number || process.env.Vault_Number;
+    const builderId = process.env.X10_BUILDER_ID || process.env.X10_Client_ID || process.env.Client_ID;
+    const l1PrivateKey = process.env.L1_PRIVATE_KEY;
+    const environment = (process.env.ENVIRONMENT || 'testnet');
+    if (requirePrivateApi) {
+        if (!apiKey)
+            throw new Error('API_KEY or X10_API_KEY is not set');
+        if (!publicKey)
+            throw new Error('Stark_Key_Public or X10_PUBLIC_KEY is not set');
+        if (!privateKey)
+            throw new Error('Stark_Key_Private or X10_PRIVATE_KEY is not set');
+        if (!vaultId)
+            throw new Error('Vault_Number or X10_VAULT_ID is not set');
+        // Ensure keys have 0x prefix
+        const normalizedPublicKey = publicKey.startsWith('0x') ? publicKey : `0x${publicKey}`;
+        const normalizedPrivateKey = privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`;
+        if (!normalizedPublicKey.match(/^0x[0-9a-fA-F]+$/)) {
+            throw new Error('Public key must be a valid hex string');
+        }
+        if (!normalizedPrivateKey.match(/^0x[0-9a-fA-F]+$/)) {
+            throw new Error('Private key must be a valid hex string');
+        }
+        return {
+            apiKey: apiKey,
+            publicKey: normalizedPublicKey,
+            privateKey: normalizedPrivateKey,
+            vaultId: parseInt(vaultId, 10),
+            builderId: builderId ? parseInt(builderId, 10) : undefined,
+            l1PrivateKey: l1PrivateKey || undefined,
+            environment,
+        };
+    }
+    return {
+        apiKey: apiKey || '',
+        publicKey: publicKey ? (publicKey.startsWith('0x') ? publicKey : `0x${publicKey}`) : '',
+        privateKey: privateKey ? (privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`) : '',
+        vaultId: vaultId ? parseInt(vaultId, 10) : 0,
+        builderId: builderId ? parseInt(builderId, 10) : undefined,
+        l1PrivateKey: l1PrivateKey || undefined,
+        environment,
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/utils/env.js.map

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