@0xmonaco/core 0.8.7-develop.34bd452 → 0.8.7-develop.a107b34

package/dist/sdk.d.ts

@@ -1,4 +1,4 @@
-import type { ApplicationsAPI, AuthAPI, AuthState, DelegatedAgentsAPI, FeesAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PositionsAPI, ProfileAPI, SDKConfig, TradingAPI, VaultAPI } from "@0xmonaco/types";
+import type { ApplicationsAPI, AuthAPI, AuthState, DelegatedAgentsAPI, FaucetAPI, FeesAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PositionsAPI, ProfileAPI, SDKConfig, SubAccountsAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
 import { type PublicClient, type TransactionReceipt, type WalletClient } from "viem";
 import { type MonacoWebSocket, OrderbookAPIImpl, TradesAPIImpl } from "./api";
 export declare class MonacoSDKImpl implements MonacoSDK {
@@ -7,10 +7,14 @@ export declare class MonacoSDKImpl implements MonacoSDK {
     applications: ApplicationsAPI;
     fees: FeesAPI;
     vault: VaultAPI;
+    withdrawals: WithdrawalsAPI;
     trading: TradingAPI;
     market: MarketAPI;
     marginAccounts: MarginAccountsAPI;
     positions: PositionsAPI;
+    subAccounts: SubAccountsAPI;
+    faucet: FaucetAPI;
+    whitelist: WhitelistAPI;
     profile: ProfileAPI;
     orderbook: OrderbookAPIImpl;
     trades: TradesAPIImpl;
@@ -25,6 +29,24 @@ export declare class MonacoSDKImpl implements MonacoSDK {
      * the WebSocket client.
      */
     private propagateSession;
+    /**
+     * Set (or clear) the application secret key used for backend-authenticated
+     * requests (those annotated `#[require_backend]` on the gateway, e.g. the
+     * `applications` reporting endpoints).
+     *
+     * The raw `sk_...` key is sent in the `x-server-key` header on each such
+     * request. This is independent of {@link login}/session auth — a client may
+     * hold both a session and a server key at once.
+     *
+     * @param serverKey - The application secret key (`sk_...`), or `undefined` to clear.
+     *
+     * @example
+     * ```typescript
+     * sdk.setServerKey("sk_live_...");
+     * const orders = await sdk.applications.listApplicationOrders({ status: "FILLED" });
+     * ```
+     */
+    setServerKey(serverKey: string | undefined): void;
     /** Extract the session keypair from an auth state. */
     private sessionFromAuthState;
     constructor(cfg: SDKConfig);
@@ -63,6 +85,15 @@ export declare class MonacoSDKImpl implements MonacoSDK {
     login(clientId: string, options?: {
         connectWebSocket?: boolean;
     }): Promise<AuthState>;
+    /**
+     * Create and adopt an owner-scoped delegated session.
+     *
+     * This must be called while authenticated as the agent wallet. The delegated
+     * session uses a fresh ed25519 keypair generated locally; the current agent
+     * session signs the registration request, and subsequent SDK calls use the
+     * delegated session keypair.
+     */
+    loginAsDelegatedOwner(ownerUserId: string): Promise<AuthState>;
     /**
      * Get the current authentication state
      *

package/dist/sdk.js

@@ -4,13 +4,18 @@ import { sei, seiTestnet } from "viem/chains";
 import { ApplicationsAPIImpl, createMonacoWebSocket, OrderbookAPIImpl, TradesAPIImpl } from "./api";
 import { AuthAPIImpl } from "./api/auth";
 import { DelegatedAgentsAPIImpl } from "./api/delegated-agents";
+import { FaucetAPIImpl } from "./api/faucet";
 import { FeesAPIImpl } from "./api/fees";
 import { MarginAccountsAPIImpl } from "./api/margin-accounts";
 import { MarketAPIImpl } from "./api/market";
 import { PositionsAPIImpl } from "./api/positions";
 import { ProfileAPIImpl } from "./api/profile";
+import { SubAccountsAPIImpl } from "./api/sub-accounts";
 import { TradingAPIImpl } from "./api/trading";
 import { VaultAPIImpl } from "./api/vault";
+import { WhitelistAPIImpl } from "./api/whitelist";
+import { WithdrawalsAPIImpl } from "./api/withdrawals";
+import { generateSessionKeypair, privateKeyHex, publicKeyHex } from "./crypto/session";
 import { APIError, InvalidConfigError, InvalidStateError } from "./errors";
 import { resolveApiUrl, resolveWsUrl } from "./networks";
 /** Validate a user-supplied URL override, returning it unchanged when valid. */
@@ -29,10 +34,14 @@ export class MonacoSDKImpl {
     applications;
     fees;
     vault;
+    withdrawals;
     trading;
     market;
     marginAccounts;
     positions;
+    subAccounts;
+    faucet;
+    whitelist;
     profile;
     orderbook;
     trades;
@@ -52,15 +61,54 @@ export class MonacoSDKImpl {
         this.applications.setSessionKeypair(credentials);
         this.fees.setSessionKeypair(credentials);
         this.vault.setSessionKeypair(credentials);
+        this.withdrawals.setSessionKeypair(credentials);
         this.trading.setSessionKeypair(credentials);
         this.market.setSessionKeypair(credentials);
         this.marginAccounts.setSessionKeypair(credentials);
         this.positions.setSessionKeypair(credentials);
+        this.subAccounts.setSessionKeypair(credentials);
+        this.faucet.setSessionKeypair(credentials);
+        this.whitelist.setSessionKeypair(credentials);
         this.profile.setSessionKeypair(credentials);
         this.orderbook.setSessionKeypair(credentials);
         this.trades.setSessionKeypair(credentials);
         this.ws.setSessionKeypair(credentials);
     }
+    /**
+     * Set (or clear) the application secret key used for backend-authenticated
+     * requests (those annotated `#[require_backend]` on the gateway, e.g. the
+     * `applications` reporting endpoints).
+     *
+     * The raw `sk_...` key is sent in the `x-server-key` header on each such
+     * request. This is independent of {@link login}/session auth — a client may
+     * hold both a session and a server key at once.
+     *
+     * @param serverKey - The application secret key (`sk_...`), or `undefined` to clear.
+     *
+     * @example
+     * ```typescript
+     * sdk.setServerKey("sk_live_...");
+     * const orders = await sdk.applications.listApplicationOrders({ status: "FILLED" });
+     * ```
+     */
+    setServerKey(serverKey) {
+        this.auth.setServerKey(serverKey);
+        this.delegatedAgents.setServerKey(serverKey);
+        this.applications.setServerKey(serverKey);
+        this.fees.setServerKey(serverKey);
+        this.vault.setServerKey(serverKey);
+        this.withdrawals.setServerKey(serverKey);
+        this.trading.setServerKey(serverKey);
+        this.market.setServerKey(serverKey);
+        this.marginAccounts.setServerKey(serverKey);
+        this.positions.setServerKey(serverKey);
+        this.subAccounts.setServerKey(serverKey);
+        this.faucet.setServerKey(serverKey);
+        this.whitelist.setServerKey(serverKey);
+        this.profile.setServerKey(serverKey);
+        this.orderbook.setServerKey(serverKey);
+        this.trades.setServerKey(serverKey);
+    }
     /** Extract the session keypair from an auth state. */
     sessionFromAuthState(authState) {
         return {
@@ -110,11 +158,15 @@ export class MonacoSDKImpl {
         this.market = new MarketAPIImpl(apiUrl);
         this.marginAccounts = new MarginAccountsAPIImpl(apiUrl);
         this.positions = new PositionsAPIImpl(apiUrl);
+        this.subAccounts = new SubAccountsAPIImpl(apiUrl);
+        this.faucet = new FaucetAPIImpl(apiUrl);
+        this.whitelist = new WhitelistAPIImpl(apiUrl);
         this.auth = new AuthAPIImpl(this.walletClient, this.chain, apiUrl);
         this.delegatedAgents = new DelegatedAgentsAPIImpl(apiUrl);
         this.fees = new FeesAPIImpl(apiUrl);
         this.profile = new ProfileAPIImpl(apiUrl);
         this.vault = new VaultAPIImpl(this.publicClient, this.walletClient, this.chain, this.applications, this.profile, apiUrl);
+        this.withdrawals = new WithdrawalsAPIImpl(apiUrl);
         this.trading = new TradingAPIImpl(apiUrl);
         this.orderbook = new OrderbookAPIImpl(apiUrl);
         this.trades = new TradesAPIImpl(apiUrl);
@@ -163,6 +215,42 @@ export class MonacoSDKImpl {
         }
         return this.authState;
     }
+    /**
+     * Create and adopt an owner-scoped delegated session.
+     *
+     * This must be called while authenticated as the agent wallet. The delegated
+     * session uses a fresh ed25519 keypair generated locally; the current agent
+     * session signs the registration request, and subsequent SDK calls use the
+     * delegated session keypair.
+     */
+    async loginAsDelegatedOwner(ownerUserId) {
+        if (!this.authState) {
+            throw new APIError("No active agent session to create delegated session", {
+                endpoint: "delegated-agents/sessions",
+                statusCode: StatusCodes.UNAUTHORIZED,
+            });
+        }
+        const keypair = generateSessionKeypair();
+        const session = {
+            publicKey: publicKeyHex(keypair),
+            privateKey: privateKeyHex(keypair),
+        };
+        const delegatedSession = await this.delegatedAgents.createDelegatedSession({
+            ownerUserId,
+            sessionPublicKey: session.publicKey,
+        });
+        this.authState = {
+            sessionPublicKey: session.publicKey,
+            sessionPrivateKey: session.privateKey,
+            expiresAt: delegatedSession.expires_at,
+            user: {
+                id: delegatedSession.owner_user_id,
+                address: delegatedSession.agent_address,
+            },
+        };
+        this.propagateSession(this.sessionFromAuthState(this.authState));
+        return this.authState;
+    }
     /**
      * Get the current authentication state
      *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/core",
-	"version": "0.8.7-develop.34bd452",
+	"version": "0.8.7-develop.a107b34",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -23,8 +23,8 @@
 		"viem": "^2.45.2"
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "0.8.7-develop.34bd452",
-		"@0xmonaco/types": "0.8.7-develop.34bd452",
+		"@0xmonaco/contracts": "0.8.7-develop.a107b34",
+		"@0xmonaco/types": "0.8.7-develop.a107b34",
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
 		"http-status-codes": "^2.3.0"