@0xmonaco/core 1.0.35 → 1.0.36

package/dist/api/index.d.ts

@@ -18,6 +18,7 @@ export * from "./positions";
 export * from "./profile";
 export * from "./pulse";
 export * from "./sub-accounts";
+export * from "./sweeper";
 export * from "./trades";
 export * from "./trading";
 export * from "./vault";

package/dist/api/index.js

@@ -18,6 +18,7 @@ export * from "./positions";
 export * from "./profile";
 export * from "./pulse";
 export * from "./sub-accounts";
+export * from "./sweeper";
 export * from "./trades";
 export * from "./trading";
 export * from "./vault";

package/dist/api/perp/routes.d.ts

@@ -152,6 +152,9 @@ export declare const perpRoutes: {
         readonly mint: () => string;
         readonly info: () => string;
     };
+    readonly sweeper: {
+        readonly register: () => string;
+    };
     readonly whitelist: {
         readonly submit: () => string;
     };

package/dist/api/perp/routes.js

@@ -82,6 +82,9 @@ export const perpRoutes = {
         mint: () => `${API_V1}/faucet/mint`,
         info: () => `${API_V1}/faucet/info`,
     },
+    sweeper: {
+        register: () => `${API_V1}/sweeper/register`,
+    },
     whitelist: {
         submit: () => `${API_V1}/whitelist`,
     },

package/dist/api/sweeper/api.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Sweeper API Implementation
+ *
+ * Public (unauthenticated) deposit-address registration. Every (application,
+ * user) pair has a deterministic deposit address; registering the pair makes
+ * the backend monitor that address and sweep every ERC20 deposit into the
+ * rollup automatically, crediting the user.
+ *
+ * The reply returns immediately with the derived address; the one-time
+ * initial balance check (sweeping anything already sitting on the address)
+ * runs in the background and is reported by `initialSweepCheck`.
+ *
+ * @example
+ * ```typescript
+ * const { status, sweeperAddress, initialSweepCheck } = await sdk.sweeper.register({
+ *   clientId: "60eb377aab9f4ea18dcdf4747204c792",
+ *   userAddress: "0x...",
+ * });
+ * ```
+ */
+import type { RegisterSweeperRequest, RegisterSweeperResponse, SweeperAPI } from "@0xmonaco/types";
+import { BaseAPI } from "../base";
+export declare class SweeperAPIImpl extends BaseAPI implements SweeperAPI {
+    /**
+     * Registers an (application, user) deposit address for monitoring. Public —
+     * no auth required.
+     *
+     * `registered` means the pair was added by this call, `already_registered`
+     * that it was known before; both carry the same derived deposit address.
+     * Idempotent and safe to retry — a repeat never re-triggers the initial
+     * balance check.
+     *
+     * @param body - The application and user identifying the pair
+     * @returns Promise resolving to the deposit address and the initial-check
+     *   state
+     */
+    register(body: RegisterSweeperRequest): Promise<RegisterSweeperResponse>;
+}

package/dist/api/sweeper/api.js

@@ -0,0 +1,43 @@
+/**
+ * Sweeper API Implementation
+ *
+ * Public (unauthenticated) deposit-address registration. Every (application,
+ * user) pair has a deterministic deposit address; registering the pair makes
+ * the backend monitor that address and sweep every ERC20 deposit into the
+ * rollup automatically, crediting the user.
+ *
+ * The reply returns immediately with the derived address; the one-time
+ * initial balance check (sweeping anything already sitting on the address)
+ * runs in the background and is reported by `initialSweepCheck`.
+ *
+ * @example
+ * ```typescript
+ * const { status, sweeperAddress, initialSweepCheck } = await sdk.sweeper.register({
+ *   clientId: "60eb377aab9f4ea18dcdf4747204c792",
+ *   userAddress: "0x...",
+ * });
+ * ```
+ */
+import { BaseAPI } from "../base";
+import { perpRoutes } from "../perp/routes";
+export class SweeperAPIImpl extends BaseAPI {
+    /**
+     * Registers an (application, user) deposit address for monitoring. Public —
+     * no auth required.
+     *
+     * `registered` means the pair was added by this call, `already_registered`
+     * that it was known before; both carry the same derived deposit address.
+     * Idempotent and safe to retry — a repeat never re-triggers the initial
+     * balance check.
+     *
+     * @param body - The application and user identifying the pair
+     * @returns Promise resolving to the deposit address and the initial-check
+     *   state
+     */
+    async register(body) {
+        return await this.makePublicRequest(perpRoutes.sweeper.register(), {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
+}

package/dist/api/sweeper/index.d.ts

@@ -0,0 +1 @@
+export { SweeperAPIImpl } from "./api";

package/dist/api/sweeper/index.js

@@ -0,0 +1 @@
+export { SweeperAPIImpl } from "./api";

package/dist/coverage.d.ts

@@ -94,6 +94,7 @@ export declare const COVERED: {
     simulate_order_risk: string;
     simulate_parent_margin_order_risk: string;
     submit_whitelist: string;
+    register_deposit_address: string;
     transfer_collateral_from_parent_margin_account: string;
     transfer_collateral_from_margin_account: string;
     transfer_collateral_to_margin_account: string;

package/dist/coverage.js

@@ -94,6 +94,7 @@ export const COVERED = {
     simulate_order_risk: "simulateOrderRisk",
     simulate_parent_margin_order_risk: "simulateParentMarginOrderRisk",
     submit_whitelist: "whitelist.submit",
+    register_deposit_address: "sweeper.register",
     transfer_collateral_from_parent_margin_account: "transferCollateralFromParentMarginAccount",
     transfer_collateral_from_margin_account: "transferCollateralFromMarginAccount",
     transfer_collateral_to_margin_account: "transferCollateralToMarginAccount",

package/dist/sdk.d.ts

@@ -1,4 +1,4 @@
-import type { ApplicationsAPI, AuthAPI, AuthState, DelegatedAgentsAPI, FaucetAPI, FeesAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PitpassAPI, PortfolioAPI, PositionsAPI, ProfileAPI, PulseAPI, SDKConfig, SubAccountsAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
+import type { ApplicationsAPI, AuthAPI, AuthState, DelegatedAgentsAPI, FaucetAPI, FeesAPI, MarginAccountsAPI, MarketAPI, MonacoSDK, Network, PitpassAPI, PortfolioAPI, PositionsAPI, ProfileAPI, PulseAPI, SDKConfig, SubAccountsAPI, SweeperAPI, TradingAPI, VaultAPI, WhitelistAPI, WithdrawalsAPI } from "@0xmonaco/types";
 import { type Address, type PublicClient, type TransactionReceipt, type WalletClient } from "viem";
 import { type MonacoWebSocket, OrderbookAPIImpl, TradesAPIImpl } from "./api";
 export declare class MonacoSDKImpl implements MonacoSDK {
@@ -16,6 +16,7 @@ export declare class MonacoSDKImpl implements MonacoSDK {
     portfolio: PortfolioAPI;
     subAccounts: SubAccountsAPI;
     faucet: FaucetAPI;
+    sweeper: SweeperAPI;
     whitelist: WhitelistAPI;
     profile: ProfileAPI;
     pulse: PulseAPI;

package/dist/sdk.js

@@ -14,6 +14,7 @@ import { PositionsAPIImpl } from "./api/positions";
 import { ProfileAPIImpl } from "./api/profile";
 import { PulseAPIImpl } from "./api/pulse";
 import { SubAccountsAPIImpl } from "./api/sub-accounts";
+import { SweeperAPIImpl } from "./api/sweeper";
 import { TradingAPIImpl } from "./api/trading";
 import { VaultAPIImpl } from "./api/vault";
 import { WhitelistAPIImpl } from "./api/whitelist";
@@ -53,6 +54,7 @@ export class MonacoSDKImpl {
     portfolio;
     subAccounts;
     faucet;
+    sweeper;
     whitelist;
     profile;
     pulse;
@@ -83,6 +85,7 @@ export class MonacoSDKImpl {
         this.portfolio.setSessionKeypair(credentials);
         this.subAccounts.setSessionKeypair(credentials);
         this.faucet.setSessionKeypair(credentials);
+        this.sweeper.setSessionKeypair(credentials);
         this.whitelist.setSessionKeypair(credentials);
         this.pulse.setSessionKeypair(credentials);
         this.profile.setSessionKeypair(credentials);
@@ -122,6 +125,7 @@ export class MonacoSDKImpl {
         this.portfolio.setServerKey(serverKey);
         this.subAccounts.setServerKey(serverKey);
         this.faucet.setServerKey(serverKey);
+        this.sweeper.setServerKey(serverKey);
         this.whitelist.setServerKey(serverKey);
         this.pulse.setServerKey(serverKey);
         this.profile.setServerKey(serverKey);
@@ -184,6 +188,7 @@ export class MonacoSDKImpl {
         this.portfolio = new PortfolioAPIImpl(apiUrl);
         this.subAccounts = new SubAccountsAPIImpl(apiUrl);
         this.faucet = new FaucetAPIImpl(apiUrl);
+        this.sweeper = new SweeperAPIImpl(apiUrl);
         this.whitelist = new WhitelistAPIImpl(apiUrl);
         this.pulse = new PulseAPIImpl(apiUrl);
         this.auth = new AuthAPIImpl(this.walletClient, this.chain, apiUrl);

package/package.json

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