@0xmonaco/core 0.1.0

package/dist/sdk.js

@@ -0,0 +1,203 @@
+/**
+ * Monaco SDK – minimal version with only Vault and Trading APIs
+ */
+import { http, createPublicClient, createWalletClient, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { CONTRACT_ADDRESSES } from "@0xmonaco/contracts";
+import { NETWORK_ENDPOINTS } from "./networks";
+import { InvalidConfigError, InitializationError, UnsupportedNetworkError, } from "./errors";
+import { VaultAPIImpl } from "./api/vault";
+import { TradingAPIImpl } from "./api/trading";
+import { AuthAPIImpl } from "./api/auth";
+import { seiMainnet, seiTestnet } from "./chains";
+// ---------------------------------------------------------------------------
+// SDK implementation
+// ---------------------------------------------------------------------------
+export class MonacoSDKImpl {
+    constructor(cfg) {
+        // Validate authentication method
+        if (!cfg.privateKey && !cfg.signer && !cfg.account) {
+            throw new InvalidConfigError("Authentication required: provide either privateKey, signer, or account", "authentication");
+        }
+        // Use provided network or default to mainnet
+        const network = cfg.network ?? "mainnet";
+        // Map network string to chain object
+        const chain = network === "testnet" ? seiTestnet : seiMainnet;
+        // Always use the chain's default RPC URL - no transport override
+        const transport = http(chain.rpcUrls.default.http[0]);
+        // Set up account with priority: account > privateKey > signer
+        let account;
+        if (cfg.account) {
+            // Custom account takes highest priority
+            account = cfg.account;
+        }
+        else if (cfg.privateKey) {
+            // Convert private key to account
+            try {
+                account = privateKeyToAccount(cfg.privateKey);
+            }
+            catch (error) {
+                throw new InvalidConfigError(`Invalid private key: ${error instanceof Error ? error.message : "Invalid format"}`, "privateKey");
+            }
+        }
+        else if (cfg.signer) {
+            // Use provided signer
+            account = cfg.signer;
+        }
+        else {
+            // This should never happen due to validation above
+            throw new InitializationError("No valid authentication method found");
+        }
+        // Create both clients internally, but only expose walletClient
+        this.publicClient = createPublicClient({
+            chain: chain,
+            transport,
+        });
+        this.walletClient = createWalletClient({
+            chain: chain,
+            account,
+            transport,
+        });
+        // Get network endpoints based on network string
+        const endpoints = NETWORK_ENDPOINTS[network];
+        // Get contract addresses from chain ID
+        const contracts = CONTRACT_ADDRESSES[chain.id];
+        // Validate that we have contract addresses for this chain
+        if (!contracts) {
+            throw new UnsupportedNetworkError(`Chain ID ${chain.id} is not supported. Supported chains: ${[seiTestnet.id, seiMainnet.id].join(", ")}`, chain.id, [seiTestnet.id, seiMainnet.id]);
+        }
+        // Instantiate APIs
+        this.auth = new AuthAPIImpl(this.walletClient, endpoints.apiUrl, chain);
+        this.vault = new VaultAPIImpl(this.publicClient, this.walletClient, contracts.vault, endpoints.apiUrl, chain);
+        this.trading = new TradingAPIImpl(endpoints.apiUrl);
+    }
+    // -----------------------------------------------------------------------
+    // Authentication
+    // -----------------------------------------------------------------------
+    /**
+     * Authenticate the user
+     * @param clientId - The client ID to use for authentication
+     * @returns The authentication response
+     */
+    async login(clientId) {
+        const response = await this.auth.authenticate(clientId);
+        this.authState = {
+            accessToken: response.accessToken,
+            refreshToken: response.refreshToken,
+            expiresAt: response.expiresAt,
+            user: response.user,
+            createdAt: Math.floor(Date.now() / 1000),
+        };
+        // Set access tokens for APIs
+        this.vault.setAccessToken(this.authState.accessToken);
+        this.trading.setAccessToken(this.authState.accessToken);
+        return this.authState;
+    }
+    /**
+     * Get the current authentication state
+     * @returns The authentication state
+     */
+    getAuthState() {
+        return this.authState;
+    }
+    /**
+     * Check if the user is authenticated
+     * @returns True if the user is authenticated
+     */
+    isAuthenticated() {
+        return !!this.authState;
+    }
+    // -----------------------------------------------------------------------
+    // Basic helpers
+    // -----------------------------------------------------------------------
+    isConnected() {
+        return !!this.walletClient;
+    }
+    /**
+     * Get the current account address
+     * @returns The account address as a string
+     */
+    getAccountAddress() {
+        return this.walletClient.account?.address ?? "";
+    }
+    /**
+     * Get the current network ('mainnet' or 'testnet')
+     * @returns The network string
+     */
+    getNetwork() {
+        return this.publicClient.chain?.id === seiTestnet.id
+            ? "testnet"
+            : "mainnet";
+    }
+    /**
+     * Get the current chain information
+     * @returns The chain configuration
+     */
+    getChain() {
+        return this.publicClient.chain;
+    }
+    /**
+     * Get the current chain ID
+     * @returns The chain ID as a number
+     */
+    getChainId() {
+        return this.publicClient.chain?.id ?? 0;
+    }
+    /**
+     * Switch to a different account
+     * @param newAccount - The new account to use
+     */
+    switchAccount(newAccount) {
+        // Create new wallet client with the new account
+        // We need to recreate the transport since we can't directly access the original
+        const transport = http(this.publicClient.chain.rpcUrls.default.http[0]);
+        this.walletClient = createWalletClient({
+            chain: this.publicClient.chain,
+            account: newAccount,
+            transport,
+        });
+    }
+    /**
+     * Switch to a different private key
+     * @param privateKey - The new private key to use
+     */
+    switchPrivateKey(privateKey) {
+        try {
+            const newAccount = privateKeyToAccount(privateKey);
+            this.switchAccount(newAccount);
+        }
+        catch (error) {
+            throw new InvalidConfigError(`Invalid private key: ${error instanceof Error ? error.message : "Invalid format"}`, "privateKey");
+        }
+    }
+    // ============================================================================
+    // Essential SDK Utilities
+    // ============================================================================
+    /**
+     * Check if the current account can sign messages
+     * @returns True if the account supports signing
+     */
+    canSign() {
+        return this.walletClient.account?.type === "local";
+    }
+    /**
+     * Wait for a transaction to be confirmed
+     * @param hash - Transaction hash
+     * @param confirmations - Number of confirmations to wait for
+     * @param timeout - Timeout in milliseconds (default: 60000ms)
+     * @returns Promise resolving to the transaction receipt
+     */
+    async waitForTransaction(hash, confirmations = 2, timeout = 60000) {
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`Transaction ${hash} timed out after ${timeout}ms`));
+            }, timeout);
+        });
+        const receiptPromise = this.publicClient.waitForTransactionReceipt({
+            hash: hash,
+            confirmations,
+        });
+        return Promise.race([receiptPromise, timeoutPromise]);
+    }
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@0xmonaco/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@0xmonaco/contracts": "0.1.0",
+    "@0xmonaco/types": "0.1.0",
+    "@0xmonaco/utils": "0.1.0",
+    "viem": "^2.30.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.30",
+    "@vitest/coverage-v8": "^1.3.1",
+    "dotenv": "^17.1.0",
+    "typescript": "5.7.3",
+    "vitest": "^1.3.1"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest --config vitest.config.ts",
+    "test:coverage": "vitest run --coverage --config vitest.config.ts"
+  }
+}