@0xmonaco/types 0.1.0

package/README.md

@@ -0,0 +1,260 @@
+# @0xmonaco/types
+
+Core type definitions for the Monaco protocol. This package provides TypeScript types and interfaces used throughout the Monaco ecosystem, focusing on SDK configuration, vault operations, trading operations, and contract management.
+
+## Installation
+
+```bash
+npm install @0xmonaco/types
+```
+
+## Type Categories
+
+### SDK Types
+
+Core SDK configuration and main interface types:
+
+```typescript
+import { MonacoSDK, SDKConfig } from "@0xmonaco/types";
+
+// SDK configuration
+interface SDKConfig {
+  privateKey?: Hex;           // Private key as hex string (0x-prefixed)
+  signer?: PrivateKeyAccount;  // Viem Account for advanced account management
+  account?: Account;           // Custom Account implementation
+  network?: Network;           // Network override (defaults to 'mainnet')
+}
+
+// Main SDK interface
+interface MonacoSDK {
+  vault: VaultAPI;           // Vault operations API
+  trading: TradingAPI;       // Trading operations API
+  walletClient: WalletClient; // Wallet client for blockchain operations
+  publicClient: PublicClient; // Public client for read-only operations
+  
+  // Account management
+  isConnected(): boolean;
+  getAccountAddress(): string;
+  getNetwork(): Network;
+  getChainId(): number;
+  switchAccount(newAccount: Account): void;
+  switchPrivateKey(privateKey: Hex): void;
+  canSign(): boolean;
+  waitForTransaction(hash: string, confirmations?: number, timeout?: number): Promise<TransactionReceipt>;
+}
+```
+
+### Vault Types
+
+Types for vault operations including deposits, withdrawals, and balance management:
+
+```typescript
+import { VaultAPI, Balance, TransactionResult } from "@0xmonaco/types";
+
+// Vault operations
+interface VaultAPI {
+  approve(token: string, amount: bigint): Promise<TransactionResult>;
+  deposit(token: string, amount: bigint): Promise<TransactionResult>;
+  withdraw(token: string, amount: bigint): Promise<TransactionResult>;
+  getBalance(token: string): Promise<Balance>;
+  getAllowance(token: string): Promise<bigint>;
+  needsApproval(token: string, amount: bigint): Promise<boolean>;
+}
+
+// Vault response types
+interface Balance {
+  token: string;
+  amount: bigint;
+  formatted: string;
+  symbol: string;
+  decimals: number;
+}
+
+interface TransactionResult {
+  hash: string;
+  status: "pending" | "confirmed" | "failed";
+  nonce: bigint;
+}
+```
+
+### Trading Types
+
+Types for trading operations including order placement and management:
+
+```typescript
+import { 
+  TradingAPI, 
+  OrderSide, 
+  OrderType, 
+  OrderIntent,
+  OrderResponse 
+} from "@0xmonaco/types";
+
+// Trading operations
+interface TradingAPI {
+  placeLimitOrder(market: string, side: OrderSide, size: bigint, price: bigint, options?: { timeInForce?: TimeInForce }): Promise<OrderResponse>;
+  placeMarketOrder(market: string, side: OrderSide, size: bigint, options?: { slippageToleranceBps?: number }): Promise<OrderResponse>;
+  placePostOnlyOrder(market: string, side: OrderSide, size: bigint, price: bigint): Promise<OrderResponse>;
+  replaceOrder(originalOrderId: string, newOrder: { market: string; side: OrderSide; size: bigint; price?: bigint; type: "limit" | "market" | "post_only"; timeInForce?: TimeInForce }): Promise<OrderResponse>;
+  cancelOrder(orderId: string): Promise<CancelOrderResponse>;
+  closePosition(market: string, options?: { maxSlippage?: number }): Promise<ClosePositionResponse>;
+}
+
+// Trading types
+type OrderSide = "buy" | "sell";
+
+type OrderType = "limit" | "market" | "post_only";
+type TimeInForce = "GTC" | "IOC" | "FOK";
+
+interface OrderIntent {
+  market: string;
+  side: OrderSide;
+  size: string;
+  orderType: OrderType;
+  userAddress: string;
+  timestamp: bigint;
+  nonce: bigint;
+  price?: string;
+  timeInForce?: TimeInForce;
+  slippageTolerance?: string;
+}
+
+// Trading response types
+interface OrderResponse {
+  orderId: string;
+  status: "accepted" | "rejected";
+  timestamp: number;
+}
+
+interface CancelOrderResponse {
+  orderId: string;
+  status: "cancelled" | "failed";
+  timestamp: number;
+}
+
+interface ClosePositionResponse {
+  market: string;
+  status: "closed" | "no_position" | "partial_close";
+  closedSize?: bigint;
+  remainingSize?: bigint;
+  timestamp: number;
+}
+```
+
+### Contract Types
+
+Types for contract addresses, instances, and contract-related operations:
+
+```typescript
+import { ContractAddresses, ContractInstances, Token, UserBalance } from "@0xmonaco/types";
+
+// Contract addresses
+interface ContractAddresses {
+  VAULT: string; // Vault contract address for managing user balances
+}
+
+// Contract instances
+type ContractInstances = {
+  vault: GetContractReturnType<typeof CONTRACT_ABIS.vault>;
+};
+
+// Contract-related types
+interface Token {
+  address: string;
+  decimals: number;
+  symbol: string;
+  name: string;
+}
+
+interface UserBalance {
+  token: Token;
+  amount: bigint;
+  formatted: string;
+}
+```
+
+### Network Types
+
+Types for network configuration:
+
+```typescript
+import { Network, NetworkEndpoints } from "@0xmonaco/types";
+
+type Network = "mainnet" | "testnet";
+
+interface NetworkEndpoints {
+  rpcUrl: string;
+  wsUrl?: string;
+}
+```
+
+## Type Reference
+
+### SDK Types
+
+- `MonacoSDK`: Main SDK interface with vault and trading APIs
+- `SDKConfig`: Configuration options for the Monaco SDK
+- `Network`: Network type ("mainnet" | "testnet")
+
+### Vault Types
+
+- `VaultAPI`: Interface for vault operations (deposits, withdrawals, balances)
+- `Balance`: Token balance information
+- `TransactionResult`: Result of blockchain transactions
+
+### Trading Types
+
+- `TradingAPI`: Interface for trading operations (orders, positions)
+- `OrderSide`: Order side type ("buy" | "sell")
+- `OrderType`: Order type for different strategies
+- `OrderIntent`: Intent interface for placing orders
+- `OrderResponse`: Response from order operations
+- `CancelOrderResponse`: Response from order cancellation
+- `ClosePositionResponse`: Response from position closing
+
+### Contract Types
+
+- `ContractAddresses`: Contract address mappings
+- `ContractInstances`: Typed contract instances
+- `Token`: Token interface with metadata
+- `UserBalance`: User's token balance information
+
+## Project Structure
+
+The types package is organized into domain-specific modules:
+
+```
+src/
+├── sdk/            # SDK types
+│   ├── index.ts   # Main SDK interfaces and configuration
+│   └── network.ts # Network-related types
+├── vault/          # Vault types
+│   ├── index.ts   # Vault API interface
+│   └── responses.ts # Vault response types
+├── trading/        # Trading types
+│   ├── index.ts   # Trading API interface
+│   ├── orders.ts  # Order-related types
+│   └── responses.ts # Trading response types
+├── contracts/      # Contract types
+│   ├── index.ts   # Contract interfaces
+│   └── balances.ts # Balance-related types
+└── index.ts        # Package exports
+```
+
+## Dependencies
+
+This package uses `viem` for blockchain-related types:
+
+- `Address`, `Hex`, `Account`, `WalletClient`, `PublicClient` from `viem`
+- `GetContractReturnType` for contract instance typing
+
+## Best Practices
+
+- Keep types focused and single-purpose
+- Use descriptive names that reflect the domain
+- Document complex types with JSDoc comments
+- Use TypeScript's strict mode
+- Maintain backward compatibility
+- Follow the established naming conventions
+- Group related types in the same file
+- Leverage `viem` types for blockchain operations rather than defining custom ones

package/dist/auth/index.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Auth Types
+ *
+ * Types for authentication operations including challenge creation,
+ * signature verification, and backend authentication.
+ */
+import { type ChallengeResponse, type VerifyResponse, type BackendAuthResponse, type TokenRefreshResponse, User } from "./responses";
+/**
+ * Auth API interface.
+ * Provides methods for frontend and backend authentication.
+ * Handles challenge creation, signature verification, and backend auth.
+ */
+export interface AuthAPI {
+    /**
+     * Complete authentication flow for frontend applications.
+     *
+     * This method handles the entire authentication process:
+     * 1. Creates a challenge
+     * 2. Signs the challenge message
+     * 3. Verifies the signature and returns JWT tokens
+     *
+     * @param clientId - Client ID of the application
+     * @returns Promise resolving to the verification response with JWT tokens
+     */
+    authenticate(clientId: string): Promise<VerifyResponse>;
+    /**
+     * Signs a challenge message using the wallet client.
+     *
+     * Signs the provided message using the wallet's private key.
+     * This is used in the authentication flow to prove ownership of the wallet.
+     *
+     * @param message - The message to sign
+     * @returns Promise resolving to the signature
+     */
+    signChallenge(message: string): Promise<string>;
+    /**
+     * Creates a challenge for frontend authentication.
+     * Generates a unique nonce and message that the user must sign with their wallet.
+     * @param address - Wallet address of the user
+     * @param clientId - Client ID of the application
+     * @returns Promise resolving to the challenge response
+     */
+    createChallenge(address: string, clientId: string): Promise<ChallengeResponse>;
+    /**
+     * Verifies a signature for frontend authentication.
+     * Validates the signature against the challenge and returns JWT tokens.
+     * @param address - Wallet address of the user
+     * @param signature - Signature of the challenge message
+     * @param nonce - Nonce from the challenge response
+     * @param clientId - Client ID of the application
+     * @returns Promise resolving to the verification response with JWT tokens
+     */
+    verifySignature(address: string, signature: string, nonce: string, clientId: string): Promise<VerifyResponse>;
+    /**
+     * Authenticates a backend service using a secret key.
+     * Returns JWT tokens for API access.
+     * @param secretKey - Secret key of the application
+     * @returns Promise resolving to the backend auth response with JWT tokens
+     */
+    authenticateBackend(secretKey: string): Promise<BackendAuthResponse>;
+    /**
+     * Refreshes an access token using a refresh token.
+     * @param refreshToken - The refresh token to use
+     * @returns Promise resolving to new access and refresh tokens
+     */
+    refreshToken(refreshToken: string): Promise<TokenRefreshResponse>;
+    /**
+     * Revokes a refresh token.
+     * @param refreshToken - The refresh token to revoke
+     * @returns Promise resolving when the token is revoked
+     */
+    revokeToken(refreshToken: string): Promise<void>;
+}
+/**
+ * Authentication state containing all tokens and metadata
+ */
+export interface AuthState {
+    /** JWT access token for authenticated requests */
+    accessToken: string;
+    /** JWT refresh token for token renewal */
+    refreshToken: string;
+    /** Unix timestamp when the access token expires */
+    expiresAt: number;
+    /** Information about the authenticated user */
+    user: User;
+    /** When the auth state was created */
+    createdAt: number;
+}
+export type { ChallengeResponse, VerifyResponse, BackendAuthResponse, TokenRefreshResponse, } from "./responses";
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,IAAI,EACL,MAAM,aAAa,CAAC;AAMrB;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAExD;;;;;;;;OAQG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhD;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE/E;;;;;;;;OAQG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE9G;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAErE;;;;OAIG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAElE;;;;OAIG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,IAAI,EAAE,IAAI,CAAC;IACX,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,8 @@
+/**
+ * Auth Types
+ *
+ * Types for authentication operations including challenge creation,
+ * signature verification, and backend authentication.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/auth/responses.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Auth Response Types
+ *
+ * Response types for authentication operations.
+ */
+/**
+ * Response to a challenge request.
+ */
+export interface ChallengeResponse {
+    /** Unique nonce for this challenge */
+    nonce: string;
+    /** Message to be signed by the user's wallet */
+    message: string;
+    /** Unix timestamp when the challenge expires */
+    expiresAt: number;
+}
+export interface User {
+    /** Unique identifier for the user */
+    id: string;
+    /** Wallet address of the user */
+    address: string;
+    /** Username of the user */
+    username?: string;
+}
+/**
+ * Response to a signature verification request.
+ */
+export interface VerifyResponse {
+    /** JWT access token for authenticated requests */
+    accessToken: string;
+    /** JWT refresh token for token renewal */
+    refreshToken: string;
+    /** Unix timestamp when the access token expires */
+    expiresAt: number;
+    /** Information about the authenticated user */
+    user: User;
+}
+export interface ApplicationInfo {
+    /** Unique identifier for the application */
+    id: string;
+    /** Human-readable name of the application */
+    name: string;
+    /** Client ID for frontend authentication */
+    clientId: string;
+}
+/**
+ * Response to a backend authentication request.
+ */
+export interface BackendAuthResponse {
+    /** JWT access token for authenticated requests */
+    accessToken: string;
+    /** Unix timestamp when the access token expires */
+    expiresAt: number;
+    /** Information about the application */
+    application: ApplicationInfo;
+}
+/**
+ * Response to a token refresh request.
+ */
+export interface TokenRefreshResponse {
+    /** New JWT access token */
+    accessToken: string;
+    /** Unix timestamp when the access token expires */
+    expiresAt: number;
+}
+//# sourceMappingURL=responses.d.ts.map

package/dist/auth/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/auth/responses.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/auth/responses.js

@@ -0,0 +1,7 @@
+/**
+ * Auth Response Types
+ *
+ * Response types for authentication operations.
+ */
+export {};
+//# sourceMappingURL=responses.js.map

package/dist/auth/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/auth/responses.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/contracts/balances.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Contract Balance Types
+ *
+ * Types for contract balance management and token information.
+ */
+import { type Address } from "viem";
+/**
+ * Type representing a token in the Monaco Markets protocol.
+ * Contains essential token metadata and contract information.
+ *
+ * @property address - Token contract address
+ * @property symbol - Token symbol (e.g. "ETH", "USDC")
+ * @property decimals - Number of decimal places for token amounts
+ * @property name - Full token name
+ */
+export interface Token {
+    /** Token contract address */
+    address: Address;
+    /** Token symbol (e.g. "ETH", "USDC") */
+    symbol: string;
+    /** Number of decimal places for token amounts */
+    decimals: number;
+    /** Full token name */
+    name: string;
+}
+/**
+ * Type representing a user's balance for a specific token in contract storage.
+ *
+ * @property token - Token address
+ * @property available - Available balance for trading
+ * @property locked - Locked balance in open orders
+ * @property total - Total balance (available + locked)
+ */
+export interface UserBalance {
+    /** Token address */
+    token: string;
+    /** Available balance for trading */
+    available: bigint;
+    /** Locked balance in open orders */
+    locked: bigint;
+    /** Total balance (available + locked) */
+    total: bigint;
+}
+//# sourceMappingURL=balances.d.ts.map

package/dist/contracts/balances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.d.ts","sourceRoot":"","sources":["../../src/contracts/balances.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAMpC;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/contracts/balances.js

@@ -0,0 +1,7 @@
+/**
+ * Contract Balance Types
+ *
+ * Types for contract balance management and token information.
+ */
+export {};
+//# sourceMappingURL=balances.js.map

package/dist/contracts/balances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.js","sourceRoot":"","sources":["../../src/contracts/balances.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/contracts/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Contract Types
+ *
+ * Types for contract addresses, instances, and contract-related operations.
+ */
+import { type GetContractReturnType } from "viem";
+import { CONTRACT_ABIS } from "@0xmonaco/contracts";
+/**
+ * Interface for all contract addresses in the Monaco Markets protocol.
+ *
+ * @property VAULT - Vault contract address for managing user balances
+ */
+export interface ContractAddresses {
+    /** Vault contract address for managing user balances */
+    VAULT: string;
+}
+/**
+ * Type representing all contract instances.
+ * Maps contract names to their typed instances with full ABI type safety.
+ *
+ * @property vault - Vault contract instance for managing user balances
+ */
+export type ContractInstances = {
+    /** Vault contract instance for managing user balances */
+    vault: GetContractReturnType<typeof CONTRACT_ABIS.vault>;
+};
+export type { Token, UserBalance } from "./balances";
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yDAAyD;IACzD,KAAK,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;CAC1D,CAAC;AAGF,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,7 @@
+/**
+ * Contract Types
+ *
+ * Types for contract addresses, instances, and contract-related operations.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Monaco Types Package
+ *
+ * This package provides TypeScript types for the Monaco protocol.
+ * It includes SDK types, vault types, trading types, contract types, and common types.
+ */
+export * from "./sdk";
+export * from "./vault";
+export * from "./trading";
+export * from "./contracts";
+export * from "./auth";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * Monaco Types Package
+ *
+ * This package provides TypeScript types for the Monaco protocol.
+ * It includes SDK types, vault types, trading types, contract types, and common types.
+ */
+// Export everything from all modules
+export * from "./sdk";
+export * from "./vault";
+export * from "./trading";
+export * from "./contracts";
+export * from "./auth";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qCAAqC;AACrC,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC"}

package/dist/sdk/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * SDK Types
+ *
+ * Core SDK configuration and main interface types.
+ */
+import { type PrivateKeyAccount, type Account, type WalletClient, type TransactionReceipt, type PublicClient, type Hex } from "viem";
+import { type Network } from "./network";
+import { type VaultAPI } from "../vault";
+import { type TradingAPI } from "../trading";
+import { AuthState, type AuthAPI } from "../auth";
+/**
+ * Configuration options for the Monaco SDK.
+ *
+ * The SDK supports multiple authentication methods:
+ * - `privateKey`: Hex string (0x-prefixed) for direct private key usage
+ * - `signer`: Viem PrivateKeyAccount for more control over account management
+ * - `account`: Custom Account implementation (overrides privateKey/signer)
+ *
+ * At least one authentication method must be provided.
+ *
+ * The SDK supports Sei Mainnet and Sei Testnet, defaulting to mainnet if no network is specified.
+ */
+export interface SDKConfig {
+    /** Private key as hex string (0x-prefixed) */
+    privateKey?: Hex;
+    /** Viem Account for advanced account management */
+    signer?: PrivateKeyAccount;
+    /** Custom Account implementation (overrides privateKey/signer) */
+    account?: Account;
+    /** Optional network override (defaults to 'mainnet') */
+    network?: Network;
+}
+/**
+ * Core SDK interface providing access to all Monaco functionality.
+ */
+export interface MonacoSDK {
+    /** Auth operations API */
+    auth: AuthAPI;
+    /** Vault operations API */
+    vault: VaultAPI;
+    /** Trading operations API */
+    trading: TradingAPI;
+    /** Wallet client for all blockchain operations */
+    walletClient: WalletClient;
+    /** Public client for read-only blockchain operations */
+    publicClient: PublicClient;
+    /** Complete authentication flow */
+    login(clientId: string): Promise<AuthState>;
+    /** Get the current authentication state */
+    getAuthState(): AuthState | undefined;
+    /** Check if the user is authenticated */
+    isAuthenticated(): boolean;
+    /** Check connection status */
+    isConnected(): boolean;
+    /** Get the current account address */
+    getAccountAddress(): string;
+    /** Get the current network ('mainnet' or 'testnet') */
+    getNetwork(): Network;
+    /** Get the current chain ID */
+    getChainId(): number;
+    /** Switch to a different account */
+    switchAccount(newAccount: Account): void;
+    /** Switch to a different private key */
+    switchPrivateKey(privateKey: Hex): void;
+    /** Check if the current account can sign messages */
+    canSign(): boolean;
+    /** Wait for a transaction to be confirmed */
+    waitForTransaction(hash: string, confirmations?: number, timeout?: number): Promise<TransactionReceipt>;
+}
+export type { Network, NetworkEndpoints } from "./network";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAkB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAMlE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,GAAG,CAAC;IAEjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,IAAI,EAAE,OAAO,CAAC;IAEd,2BAA2B;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAEhB,6BAA6B;IAC7B,OAAO,EAAE,UAAU,CAAC;IAEpB,kDAAkD;IAClD,YAAY,EAAE,YAAY,CAAC;IAE3B,wDAAwD;IACxD,YAAY,EAAE,YAAY,CAAC;IAE3B,mCAAmC;IACnC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE5C,2CAA2C;IAC3C,YAAY,IAAI,SAAS,GAAG,SAAS,CAAC;IAEtC,yCAAyC;IACzC,eAAe,IAAI,OAAO,CAAC;IAE3B,8BAA8B;IAC9B,WAAW,IAAI,OAAO,CAAC;IAEvB,sCAAsC;IACtC,iBAAiB,IAAI,MAAM,CAAC;IAE5B,uDAAuD;IACvD,UAAU,IAAI,OAAO,CAAC;IAEtB,+BAA+B;IAC/B,UAAU,IAAI,MAAM,CAAC;IAErB,oCAAoC;IACpC,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAEzC,wCAAwC;IACxC,gBAAgB,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;IAExC,qDAAqD;IACrD,OAAO,IAAI,OAAO,CAAC;IAEnB,6CAA6C;IAC7C,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC;AAGD,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/sdk/index.js

@@ -0,0 +1,7 @@
+/**
+ * SDK Types
+ *
+ * Core SDK configuration and main interface types.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/sdk/network.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Network Types
+ *
+ * Network configuration and endpoint types for the Monaco SDK.
+ */
+/**
+ * Supported network types for the Monaco SDK.
+ *
+ * The SDK supports Sei Mainnet and Sei Testnet networks.
+ */
+export type Network = "mainnet" | "testnet";
+/**
+ * Network endpoint configuration for the Monaco SDK.
+ *
+ * Contains the RPC URL and API URL for each supported network.
+ */
+export interface NetworkEndpoints {
+    rpcUrl: string;
+    apiUrl: string;
+}
+//# sourceMappingURL=network.d.ts.map

package/dist/sdk/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/sdk/network.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/sdk/network.js

@@ -0,0 +1,7 @@
+/**
+ * Network Types
+ *
+ * Network configuration and endpoint types for the Monaco SDK.
+ */
+export {};
+//# sourceMappingURL=network.js.map

package/dist/sdk/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/sdk/network.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/trading/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Trading Types
+ *
+ * Types for trading operations including order placement and management.
+ */
+import { type OrderSide } from "./orders";
+import { type CancelOrderResponse, type UpdateOrderResponse, type CreateOrderResponse } from "./responses";
+/**
+ * Trading API interface.
+ * Provides methods for placing and managing orders.
+ * Handles order placement, cancellation, and execution.
+ */
+export interface TradingAPI {
+    /**
+     * Set the access token for the TradingAPI
+     * @param token - The access token to set
+     */
+    setAccessToken(token: string): void;
+    /**
+     * Places a limit order on the order book.
+     * @param market - Market identifier (e.g., "ETH-USD")
+     * @param side - Order side ("BUY" or "SELL")
+     * @param quantity - Order quantity as string
+     * @param price - Order price as string
+     * @param options - Optional parameters for the limit order
+     * @param options.tradingMode - Trading mode (e.g., "SPOT")
+     * @returns Promise resolving to the order result
+     */
+    placeLimitOrder(market: string, side: OrderSide, quantity: string, price: string, options?: {
+        tradingMode?: string;
+    }): Promise<CreateOrderResponse>;
+    /**
+     * Places a market order for immediate execution.
+     * @param market - Market identifier (e.g., "ETH-USD")
+     * @param side - Order side ("BUY" or "SELL")
+     * @param quantity - Order quantity as string
+     * @param options - Optional parameters for the market order
+     * @param options.tradingMode - Trading mode (e.g., "SPOT")
+     * @returns Promise resolving to the order result
+     */
+    placeMarketOrder(market: string, side: OrderSide, quantity: string, options?: {
+        tradingMode?: string;
+    }): Promise<CreateOrderResponse>;
+    /**
+     * Cancels an existing order.
+     * @param orderId - ID of the order to cancel
+     * @returns Promise resolving to the cancellation result
+     */
+    cancelOrder(orderId: string): Promise<CancelOrderResponse>;
+    /**
+     * Updates an existing order (price and/or quantity).
+     * @param orderId - ID of the order to update
+     * @param updates - Fields to update
+     * @param updates.price - New price (optional)
+     * @param updates.quantity - New quantity (optional)
+     * @returns Promise resolving to the update result
+     */
+    updateOrder(orderId: string, updates: {
+        price?: string;
+        quantity?: string;
+    }): Promise<UpdateOrderResponse>;
+}
+export type { OrderSide, OrderType, } from "./orders";
+export type { OrderResponse, CancelOrderResponse, UpdateOrderResponse, CreateOrderResponse } from "./responses";
+//# sourceMappingURL=index.d.ts.map

package/dist/trading/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trading/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AAMrB;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;OASG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;;;;;OAQG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE3D;;;;;;;OAOG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAGD,YAAY,EACV,SAAS,EACT,SAAS,GACV,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,aAAa,CAAC"}

package/dist/trading/index.js

@@ -0,0 +1,7 @@
+/**
+ * Trading Types
+ *
+ * Types for trading operations including order placement and management.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/trading/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trading/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/trading/orders.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Trading Order Types
+ *
+ * Types for trading operations and order management.
+ */
+/**
+ * Order side for trading operations
+ */
+export type OrderSide = "BUY" | "SELL";
+/**
+ * Order type for different order strategies
+ */
+export type OrderType = "LIMIT" | "MARKET" | "POST_ONLY";
+/**
+ * Order status for different order states
+ */
+export type OrderStatus = "SUBMITTED" | "FILLED" | "CANCELLED" | "REJECTED" | "PARTIALLY_FILLED";
+/**
+ * Trading mode
+ */
+export type TradingMode = "SPOT" | "MARGIN" | "FUTURES";
+//# sourceMappingURL=orders.d.ts.map

package/dist/trading/orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../src/trading/orders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,QAAQ,GACR,WAAW,GACX,UAAU,GACV,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC"}

package/dist/trading/orders.js

@@ -0,0 +1,7 @@
+/**
+ * Trading Order Types
+ *
+ * Types for trading operations and order management.
+ */
+export {};
+//# sourceMappingURL=orders.js.map

package/dist/trading/orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../src/trading/orders.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/trading/responses.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Trading Response Types
+ *
+ * Response types for trading operations.
+ */
+/**
+ * Response from creating an order.
+ */
+export interface CreateOrderResponse {
+    /** Order identifier */
+    order_id: string;
+    /** Order status */
+    status: "SUCCESS" | "FAILED";
+    /** Match result information */
+    match_result?: {
+        /** Remaining quantity after immediate matches */
+        remaining_quantity: string;
+        /** Status of the match */
+        status: string;
+    };
+}
+/**
+ * Response from cancelling an order.
+ */
+export interface CancelOrderResponse {
+    /** Order identifier */
+    order_id: string;
+    /** Cancellation status */
+    status: "SUCCESS" | "FAILED";
+}
+/**
+ * Response from updating an order.
+ */
+export interface UpdateOrderResponse {
+    /** Order identifier */
+    order_id: string;
+    /** Update status */
+    status: "SUCCESS" | "FAILED";
+    /** Updated fields */
+    updated_fields: {
+        /** Updated price if changed */
+        price?: string;
+        /** Updated quantity if changed */
+        quantity?: string;
+    };
+}
+/**
+ * Response from placing an order (legacy - kept for backward compatibility).
+ */
+export interface OrderResponse {
+    /** Order identifier */
+    orderId: string;
+    /** Order status */
+    status: "accepted" | "rejected";
+    /** Timestamp of the response */
+    timestamp: number;
+}
+/**
+ * Response from closing a position (legacy - kept for backward compatibility).
+ */
+export interface ClosePositionResponse {
+    /** Market identifier */
+    market: string;
+    /** Close position status */
+    status: "closed" | "no_position" | "partial_close";
+    /** Amount that was closed */
+    closedSize?: bigint;
+    /** Remaining position size */
+    remainingSize?: bigint;
+    /** Timestamp of the response */
+    timestamp: number;
+}
+//# sourceMappingURL=responses.d.ts.map

package/dist/trading/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/trading/responses.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,+BAA+B;IAC/B,YAAY,CAAC,EAAE;QACb,iDAAiD;QACjD,kBAAkB,EAAE,MAAM,CAAC;QAC3B,0BAA0B;QAC1B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,qBAAqB;IACrB,cAAc,EAAE;QACd,+BAA+B;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,kCAAkC;QAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC;IACnD,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/trading/responses.js

@@ -0,0 +1,7 @@
+/**
+ * Trading Response Types
+ *
+ * Response types for trading operations.
+ */
+export {};
+//# sourceMappingURL=responses.js.map

package/dist/trading/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/trading/responses.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/vault/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Vault Types
+ *
+ * Types for vault operations including deposits, withdrawals, and balance management.
+ */
+import { type Balance, type TransactionResult } from "./responses";
+/**
+ * Vault API interface.
+ * Provides methods for managing token deposits and withdrawals.
+ * Handles token approvals and balance management.
+ */
+export interface VaultAPI {
+    /**
+     * Approves the vault to spend tokens.
+     * @param token - Address of the token to approve
+     * @param amount - Amount to approve
+     * @returns Promise resolving to the transaction result
+     */
+    approve(token: string, amount: bigint): Promise<TransactionResult>;
+    /**
+     * Deposits tokens into the vault.
+     * @param token - Address of the token to deposit
+     * @param amount - Amount to deposit
+     * @returns Promise resolving to the transaction result
+     */
+    deposit(token: string, amount: bigint): Promise<TransactionResult>;
+    /**
+     * Withdraws tokens from the vault.
+     * @param token - Address of the token to withdraw
+     * @param amount - Amount to withdraw
+     * @returns Promise resolving to the transaction result
+     */
+    withdraw(token: string, amount: bigint): Promise<TransactionResult>;
+    /**
+     * Gets the balance of a token in the vault.
+     * @param token - Address of the token to check
+     * @returns Promise resolving to the balance
+     */
+    getBalance(token: string): Promise<Balance>;
+    /**
+     * Gets the allowance for a token.
+     * @param token - Address of the token to check
+     * @returns Promise resolving to the allowance
+     */
+    getAllowance(token: string): Promise<bigint>;
+    /**
+     * Checks if a token needs approval for an amount.
+     * @param token - Address of the token to check
+     * @param amount - Amount to check
+     * @returns Promise resolving to whether approval is needed
+     */
+    needsApproval(token: string, amount: bigint): Promise<boolean>;
+    /**
+     * Set the access token for the VaultAPI
+     * @param token - The access token to set
+     */
+    setAccessToken(token: string): void;
+}
+export type { Balance, TransactionResult } from "./responses";
+//# sourceMappingURL=index.d.ts.map

package/dist/vault/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vault/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMnE;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEpE;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7C;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/D;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAGD,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/vault/index.js

@@ -0,0 +1,7 @@
+/**
+ * Vault Types
+ *
+ * Types for vault operations including deposits, withdrawals, and balance management.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/vault/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vault/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/vault/responses.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Vault Response Types
+ *
+ * Response types for vault operations.
+ */
+/**
+ * Response from a transaction.
+ */
+export interface TransactionResult {
+    /** Transaction hash */
+    hash: string;
+    /** Transaction status */
+    status: "pending" | "confirmed" | "failed";
+    /** Nonce used for this operation */
+    nonce: bigint;
+}
+/**
+ * Token balance information.
+ */
+export interface Balance {
+    /** Token address */
+    token: string;
+    /** Balance amount */
+    amount: bigint;
+    /** Formatted balance string */
+    formatted: string;
+    /** Token symbol */
+    symbol: string;
+    /** Token decimals */
+    decimals: number;
+}
+//# sourceMappingURL=responses.d.ts.map

package/dist/vault/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/vault/responses.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/vault/responses.js

@@ -0,0 +1,7 @@
+/**
+ * Vault Response Types
+ *
+ * Response types for vault operations.
+ */
+export {};
+//# sourceMappingURL=responses.js.map

package/dist/vault/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/vault/responses.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@0xmonaco/types",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "viem": "^2.30.6"
+  },
+  "devDependencies": {
+    "typescript": "5.7.3"
+  },
+  "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"
+  }
+}