@decibeltrade/sdk 0.3.0 → 0.4.0

package/dist/read/market-depth/market-depth.types.d.ts

@@ -10,14 +10,17 @@ export declare const MarketOrderSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const MarketDepthSchema: z.ZodObject<{
     market: z.ZodString;
-    bids: z.ZodArray<z.ZodObject<{
+    asks: z.ZodArray<z.ZodObject<{
         price: z.ZodNumber;
         size: z.ZodNumber;
     }, z.core.$strip>>;
-    asks: z.ZodArray<z.ZodObject<{
+    bids: z.ZodArray<z.ZodObject<{
         price: z.ZodNumber;
         size: z.ZodNumber;
     }, z.core.$strip>>;
+    best_ask: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    best_bid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    unix_ms: z.ZodNumber;
 }, z.core.$strip>;
 export type MarketDepthAggregationSize = 1 | 2 | 5 | 10 | 100 | 1000;
 export type MarketOrder = z.infer<typeof MarketOrderSchema>;

package/dist/read/market-depth/market-depth.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"market-depth.types.d.ts","sourceRoot":"","sources":["../../../src/read/market-depth/market-depth.types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;iBAI5B,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC;AACrE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"market-depth.types.d.ts","sourceRoot":"","sources":["../../../src/read/market-depth/market-depth.types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAO5B,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC;AACrE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/read/market-depth/market-depth.types.js

@@ -5,6 +5,9 @@ export const MarketOrderSchema = z.object({
 });
 export const MarketDepthSchema = z.object({
     market: z.string(),
-    bids: z.array(MarketOrderSchema),
     asks: z.array(MarketOrderSchema),
+    bids: z.array(MarketOrderSchema),
+    best_ask: z.number().nullable().optional(),
+    best_bid: z.number().nullable().optional(),
+    unix_ms: z.number(),
 });

package/dist/read/market-trades/market-trades.reader.d.ts

@@ -15,7 +15,6 @@ export declare class MarketTradesReader extends BaseReader {
         price: number;
         is_profit: boolean;
         realized_pnl_amount: number;
-        is_funding_positive: boolean;
         realized_funding_amount: number;
         is_rebate: boolean;
         fee_amount: number;

package/dist/read/market-trades/market-trades.reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"market-trades.reader.d.ts","sourceRoot":"","sources":["../../../src/read/market-trades/market-trades.reader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAEL,uBAAuB,EACvB,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,kBAAmB,SAAQ,UAAU;IAChD;;;;;OAKG;IACG,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,uBAAuB;;;;;;;;;;;;;;;IAiB5E;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI;CAMjF"}
+{"version":3,"file":"market-trades.reader.d.ts","sourceRoot":"","sources":["../../../src/read/market-trades/market-trades.reader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAEL,uBAAuB,EACvB,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,kBAAmB,SAAQ,UAAU;IAChD;;;;;OAKG;IACG,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,uBAAuB;;;;;;;;;;;;;;IAiB5E;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI;CAMjF"}

package/dist/read/market-trades/market-trades.types.d.ts

@@ -12,7 +12,6 @@ export declare const MarketTradeSchema: z.ZodObject<{
     price: z.ZodNumber;
     is_profit: z.ZodBoolean;
     realized_pnl_amount: z.ZodNumber;
-    is_funding_positive: z.ZodBoolean;
     realized_funding_amount: z.ZodNumber;
     is_rebate: z.ZodBoolean;
     fee_amount: z.ZodNumber;
@@ -28,7 +27,6 @@ export declare const MarketTradesHistorySchema: z.ZodObject<{
         price: z.ZodNumber;
         is_profit: z.ZodBoolean;
         realized_pnl_amount: z.ZodNumber;
-        is_funding_positive: z.ZodBoolean;
         realized_funding_amount: z.ZodNumber;
         is_rebate: z.ZodBoolean;
         fee_amount: z.ZodNumber;
@@ -46,7 +44,6 @@ export declare const MarketTradeWsMessageSchema: z.ZodObject<{
         price: z.ZodNumber;
         is_profit: z.ZodBoolean;
         realized_pnl_amount: z.ZodNumber;
-        is_funding_positive: z.ZodBoolean;
         realized_funding_amount: z.ZodNumber;
         is_rebate: z.ZodBoolean;
         fee_amount: z.ZodNumber;

package/dist/read/market-trades/market-trades.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"market-trades.types.d.ts","sourceRoot":"","sources":["../../../src/read/market-trades/market-trades.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;iBAc5B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;iBAGpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;iBAErC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"market-trades.types.d.ts","sourceRoot":"","sources":["../../../src/read/market-trades/market-trades.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAa5B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;iBAGpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;iBAErC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/read/market-trades/market-trades.types.js

@@ -7,7 +7,6 @@ export const MarketTradeSchema = z.object({
     price: z.number(),
     is_profit: z.boolean(),
     realized_pnl_amount: z.number(),
-    is_funding_positive: z.boolean(),
     realized_funding_amount: z.number(),
     is_rebate: z.boolean(),
     fee_amount: z.number(),

package/dist/read/points-leaderboard/points-leaderboard.reader.d.ts

@@ -0,0 +1,21 @@
+import { BaseReader } from "../base-reader";
+import { PointsLeaderboardRequestArgs } from "./points-leaderboard.types";
+export declare class PointsLeaderboardReader extends BaseReader {
+    /**
+     * Get the points leaderboard (Hz/Amps rankings)
+     * @param queryParams The query parameters for the points leaderboard
+     * @returns The points leaderboard
+     */
+    getPointsLeaderboard({ fetchOptions, tier, ...args }: PointsLeaderboardRequestArgs): Promise<{
+        items: {
+            rank: number;
+            owner: string;
+            total_amps: number;
+            realized_pnl: number;
+            referral_amps: number;
+            vault_amps: number;
+        }[];
+        total_count: number;
+    }>;
+}
+//# sourceMappingURL=points-leaderboard.reader.d.ts.map

package/dist/read/points-leaderboard/points-leaderboard.reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"points-leaderboard.reader.d.ts","sourceRoot":"","sources":["../../../src/read/points-leaderboard/points-leaderboard.reader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,4BAA4B,EAA2B,MAAM,4BAA4B,CAAC;AAEnG,qBAAa,uBAAwB,SAAQ,UAAU;IACrD;;;;OAIG;IACG,oBAAoB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,4BAA4B;;;;;;;;;;;CAezF"}

package/dist/read/points-leaderboard/points-leaderboard.reader.js

@@ -0,0 +1,23 @@
+import { constructKnownQueryParams } from "../../utils";
+import { BaseReader } from "../base-reader";
+import { PointsLeaderboardSchema } from "./points-leaderboard.types";
+export class PointsLeaderboardReader extends BaseReader {
+    /**
+     * Get the points leaderboard (Hz/Amps rankings)
+     * @param queryParams The query parameters for the points leaderboard
+     * @returns The points leaderboard
+     */
+    async getPointsLeaderboard({ fetchOptions, tier, ...args }) {
+        const queryParams = constructKnownQueryParams(args);
+        if (tier) {
+            queryParams.set("tier", tier);
+        }
+        const response = await this.getRequest({
+            schema: PointsLeaderboardSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/points_leaderboard`,
+            queryParams,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+}

package/dist/read/points-leaderboard/points-leaderboard.types.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod/v4";
+import { BaseRequestArgs } from "../base-reader";
+import { PageParams, SearchTermParams, SortParams } from "../types";
+export type PointsLeaderboardSortKey = "total_amps" | "realized_pnl";
+export type PointsLeaderboardTierFilter = "top20" | "diamond" | "doublePlatinum" | "gold";
+export interface PointsLeaderboardRequestArgs extends BaseRequestArgs, PageParams, SearchTermParams, SortParams<PointsLeaderboardSortKey> {
+    tier?: PointsLeaderboardTierFilter;
+}
+export declare const PointsLeaderboardItemSchema: z.ZodObject<{
+    rank: z.ZodNumber;
+    owner: z.ZodString;
+    total_amps: z.ZodNumber;
+    realized_pnl: z.ZodNumber;
+    referral_amps: z.ZodNumber;
+    vault_amps: z.ZodNumber;
+}, z.core.$strip>;
+export declare const PointsLeaderboardSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        rank: z.ZodNumber;
+        owner: z.ZodString;
+        total_amps: z.ZodNumber;
+        realized_pnl: z.ZodNumber;
+        referral_amps: z.ZodNumber;
+        vault_amps: z.ZodNumber;
+    }, z.core.$strip>>;
+    total_count: z.ZodNumber;
+}, z.core.$strip>;
+export type PointsLeaderboardItem = z.infer<typeof PointsLeaderboardItemSchema>;
+export type PointsLeaderboard = z.infer<typeof PointsLeaderboardSchema>;
+//# sourceMappingURL=points-leaderboard.types.d.ts.map

package/dist/read/points-leaderboard/points-leaderboard.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"points-leaderboard.types.d.ts","sourceRoot":"","sources":["../../../src/read/points-leaderboard/points-leaderboard.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAA2B,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE7F,MAAM,MAAM,wBAAwB,GAAG,YAAY,GAAG,cAAc,CAAC;AAErE,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,SAAS,GAAG,gBAAgB,GAAG,MAAM,CAAC;AAE1F,MAAM,WAAW,4BACf,SAAQ,eAAe,EACrB,UAAU,EACV,gBAAgB,EAChB,UAAU,CAAC,wBAAwB,CAAC;IACtC,IAAI,CAAC,EAAE,2BAA2B,CAAC;CACpC;AAED,eAAO,MAAM,2BAA2B;;;;;;;iBAOtC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAAuD,CAAC;AAE5F,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/read/points-leaderboard/points-leaderboard.types.js

@@ -0,0 +1,11 @@
+import { z } from "zod/v4";
+import { PaginatedResponseSchema } from "../types";
+export const PointsLeaderboardItemSchema = z.object({
+    rank: z.number(),
+    owner: z.string(),
+    total_amps: z.number(),
+    realized_pnl: z.number(),
+    referral_amps: z.number(),
+    vault_amps: z.number(),
+});
+export const PointsLeaderboardSchema = PaginatedResponseSchema(PointsLeaderboardItemSchema);

package/dist/read/portfolio-chart/portfolio-chart.types.d.ts

@@ -14,7 +14,7 @@ export declare const PortfolioChartSchema: z.ZodArray<z.ZodObject<{
     data_points: z.ZodNumber;
 }, z.core.$strip>>;
 export type PortfolioChartType = "pnl" | "account_value";
-export type PortfolioChartTimeRange = "24h" | "7d" | "30d" | "90d";
+export type PortfolioChartTimeRange = "24h" | "7d" | "30d" | "90d" | "all";
 export type PortfolioChartItem = z.infer<typeof PortfolioChartPnlItemSchema>;
 export type PortfolioChart = z.infer<typeof PortfolioChartSchema>;
 //# sourceMappingURL=portfolio-chart.types.d.ts.map

package/dist/read/portfolio-chart/portfolio-chart.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portfolio-chart.types.d.ts","sourceRoot":"","sources":["../../../src/read/portfolio-chart/portfolio-chart.types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;kBAAuC,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,eAAe,CAAC;AACzD,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"portfolio-chart.types.d.ts","sourceRoot":"","sources":["../../../src/read/portfolio-chart/portfolio-chart.types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;kBAAuC,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,eAAe,CAAC;AACzD,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAC3E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/read/referrals/referrals.reader.d.ts

@@ -0,0 +1,98 @@
+import { BaseReader, BaseRequestArgs } from "../base-reader";
+import { UserReferralsRequestArgs } from "./referrals.types";
+export declare class ReferralsReader extends BaseReader {
+    /**
+     * Validate a referral code (check existence and active status).
+     */
+    validateCode(code: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        referral_code: string;
+        is_valid: boolean;
+        is_active: boolean;
+    }>;
+    /**
+     * Get referral information for a specific account.
+     */
+    getAccountReferral(account: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        account: string;
+        referrer_account: string;
+        referral_code: string;
+        is_affiliate_referral: boolean;
+        referred_at_ms: number;
+        is_active: boolean;
+    }>;
+    /**
+     * Redeem a referral code for an account.
+     */
+    redeemCode(args: {
+        referralCode: string;
+        account: string;
+    }, { fetchOptions }?: BaseRequestArgs): Promise<{
+        referral_code: string;
+        account: string;
+    }>;
+    /**
+     * Get aggregate referral statistics for a referrer.
+     */
+    getReferrerStats(account: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        referrer_account: string;
+        total_referrals: number;
+        total_codes_created: number;
+        is_affiliate: boolean;
+        codes: string[];
+        volume_threshold_met: boolean;
+    }>;
+    /**
+     * Get paginated list of users referred by a referrer.
+     */
+    getUserReferrals({ referrerAccount, limit, offset, fetchOptions, }: UserReferralsRequestArgs): Promise<{
+        account: string;
+        referrer_account: string;
+        referral_code: string;
+        is_affiliate_referral: boolean;
+        referred_at_ms: number;
+    }[]>;
+    /**
+     * Get all referral codes owned by an account with per-code usage stats.
+     */
+    getAffiliateCodes(account: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        owner_account: string;
+        codes: {
+            referral_code: string;
+            owner_account: string;
+            max_usage: number;
+            usage_count: number;
+            is_active: boolean;
+            is_affiliate: boolean;
+            source: "unknown" | "admin" | "auto" | "predeposit";
+            created_at_ms: number;
+        }[];
+        volume_threshold_met: boolean;
+    }>;
+    /**
+     * Get affiliate earnings breakdown and referred users for an account.
+     */
+    getAffiliateEarnings(account: string, { fetchOptions }?: BaseRequestArgs): Promise<{
+        affiliate_account: string;
+        is_affiliate: boolean;
+        earnings: {
+            l1_amps: number;
+            l2_amps: number;
+            total_amps: number;
+            l1_count: number;
+            l2_count: number;
+        };
+        users: {
+            items: {
+                account: string;
+                level: "L1" | "L2";
+                referred_by: string | null;
+                total_amps: number;
+                affiliate_amps_earned: number;
+                total_volume: number;
+                active: boolean;
+            }[];
+            total_count: number;
+        };
+    }>;
+}
+//# sourceMappingURL=referrals.reader.d.ts.map

package/dist/read/referrals/referrals.reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referrals.reader.d.ts","sourceRoot":"","sources":["../../../src/read/referrals/referrals.reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAOL,wBAAwB,EAEzB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,eAAgB,SAAQ,UAAU;IAC7C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;IASvE;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;;;;IAShF;;OAEG;IACG,UAAU,CACd,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAC/C,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;IAWxC;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;;;;IAS9E;;OAEG;IACG,gBAAgB,CAAC,EACrB,eAAe,EACf,KAAK,EACL,MAAM,EACN,YAAY,GACb,EAAE,wBAAwB;;;;;;;IAmB3B;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;;;;;;;;;;IAS/E;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,GAAE,eAAoB;;;;;;;;;;;;;;;;;;;;;;;CAUnF"}

package/dist/read/referrals/referrals.reader.js

@@ -0,0 +1,92 @@
+import { BaseReader } from "../base-reader";
+import { AccountReferralSchema, AffiliateCodesResponseSchema, AffiliateEarningsResponseSchema, RedeemReferralResponseSchema, ReferralCodeValidationSchema, ReferrerStatsSchema, UserReferralsResponseSchema, } from "./referrals.types";
+export class ReferralsReader extends BaseReader {
+    /**
+     * Validate a referral code (check existence and active status).
+     */
+    async validateCode(code, { fetchOptions } = {}) {
+        const response = await this.getRequest({
+            schema: ReferralCodeValidationSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/code/${encodeURIComponent(code)}`,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get referral information for a specific account.
+     */
+    async getAccountReferral(account, { fetchOptions } = {}) {
+        const response = await this.getRequest({
+            schema: AccountReferralSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/account/${account}`,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Redeem a referral code for an account.
+     */
+    async redeemCode(args, { fetchOptions } = {}) {
+        const response = await this.postRequest({
+            schema: RedeemReferralResponseSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/redeem`,
+            body: { referral_code: args.referralCode, account: args.account },
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get aggregate referral statistics for a referrer.
+     */
+    async getReferrerStats(account, { fetchOptions } = {}) {
+        const response = await this.getRequest({
+            schema: ReferrerStatsSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/stats/${account}`,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get paginated list of users referred by a referrer.
+     */
+    async getUserReferrals({ referrerAccount, limit, offset, fetchOptions, }) {
+        const queryParams = new URLSearchParams({ referrer_account: referrerAccount });
+        if (limit !== undefined) {
+            queryParams.set("limit", limit.toString());
+        }
+        if (offset !== undefined) {
+            queryParams.set("offset", offset.toString());
+        }
+        const response = await this.getRequest({
+            schema: UserReferralsResponseSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/referrals/users`,
+            queryParams,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get all referral codes owned by an account with per-code usage stats.
+     */
+    async getAffiliateCodes(account, { fetchOptions } = {}) {
+        const response = await this.getRequest({
+            schema: AffiliateCodesResponseSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/affiliates/codes/${account}`,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+    /**
+     * Get affiliate earnings breakdown and referred users for an account.
+     */
+    async getAffiliateEarnings(account, { fetchOptions } = {}) {
+        const queryParams = new URLSearchParams({ limit: "1000" });
+        const response = await this.getRequest({
+            schema: AffiliateEarningsResponseSchema,
+            url: `${this.deps.config.tradingHttpUrl}/api/v1/affiliates/earnings/${account}`,
+            queryParams,
+            options: fetchOptions,
+        });
+        return response.data;
+    }
+}

package/dist/read/referrals/referrals.types.d.ts

@@ -0,0 +1,136 @@
+import { z } from "zod/v4";
+import { BaseRequestArgs } from "../base-reader";
+import { PageParams } from "../pagination.types";
+export interface UserReferralsRequestArgs extends BaseRequestArgs, PageParams {
+    referrerAccount: string;
+}
+export declare const ReferralCodeValidationSchema: z.ZodObject<{
+    referral_code: z.ZodString;
+    is_valid: z.ZodBoolean;
+    is_active: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const RedeemReferralResponseSchema: z.ZodObject<{
+    referral_code: z.ZodString;
+    account: z.ZodString;
+}, z.core.$strip>;
+export declare const AccountReferralSchema: z.ZodObject<{
+    account: z.ZodString;
+    referrer_account: z.ZodString;
+    referral_code: z.ZodString;
+    is_affiliate_referral: z.ZodBoolean;
+    referred_at_ms: z.ZodNumber;
+    is_active: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const ReferrerStatsSchema: z.ZodObject<{
+    referrer_account: z.ZodString;
+    total_referrals: z.ZodNumber;
+    total_codes_created: z.ZodNumber;
+    is_affiliate: z.ZodBoolean;
+    codes: z.ZodArray<z.ZodString>;
+    volume_threshold_met: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const UserReferralSchema: z.ZodObject<{
+    account: z.ZodString;
+    referrer_account: z.ZodString;
+    referral_code: z.ZodString;
+    is_affiliate_referral: z.ZodBoolean;
+    referred_at_ms: z.ZodNumber;
+}, z.core.$strip>;
+export declare const UserReferralsResponseSchema: z.ZodArray<z.ZodObject<{
+    account: z.ZodString;
+    referrer_account: z.ZodString;
+    referral_code: z.ZodString;
+    is_affiliate_referral: z.ZodBoolean;
+    referred_at_ms: z.ZodNumber;
+}, z.core.$strip>>;
+export declare const AffiliateCodeSchema: z.ZodObject<{
+    referral_code: z.ZodString;
+    owner_account: z.ZodString;
+    max_usage: z.ZodNumber;
+    usage_count: z.ZodNumber;
+    is_active: z.ZodBoolean;
+    is_affiliate: z.ZodBoolean;
+    source: z.ZodEnum<{
+        unknown: "unknown";
+        admin: "admin";
+        auto: "auto";
+        predeposit: "predeposit";
+    }>;
+    created_at_ms: z.ZodNumber;
+}, z.core.$strip>;
+export declare const AffiliateCodesResponseSchema: z.ZodObject<{
+    owner_account: z.ZodString;
+    codes: z.ZodArray<z.ZodObject<{
+        referral_code: z.ZodString;
+        owner_account: z.ZodString;
+        max_usage: z.ZodNumber;
+        usage_count: z.ZodNumber;
+        is_active: z.ZodBoolean;
+        is_affiliate: z.ZodBoolean;
+        source: z.ZodEnum<{
+            unknown: "unknown";
+            admin: "admin";
+            auto: "auto";
+            predeposit: "predeposit";
+        }>;
+        created_at_ms: z.ZodNumber;
+    }, z.core.$strip>>;
+    volume_threshold_met: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const AffiliateReferredUserSchema: z.ZodObject<{
+    account: z.ZodString;
+    level: z.ZodEnum<{
+        L1: "L1";
+        L2: "L2";
+    }>;
+    referred_by: z.ZodNullable<z.ZodString>;
+    total_amps: z.ZodNumber;
+    affiliate_amps_earned: z.ZodNumber;
+    total_volume: z.ZodNumber;
+    active: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const AffiliateEarningsBreakdownSchema: z.ZodObject<{
+    l1_amps: z.ZodNumber;
+    l2_amps: z.ZodNumber;
+    total_amps: z.ZodNumber;
+    l1_count: z.ZodNumber;
+    l2_count: z.ZodNumber;
+}, z.core.$strip>;
+export declare const AffiliateEarningsResponseSchema: z.ZodObject<{
+    affiliate_account: z.ZodString;
+    is_affiliate: z.ZodBoolean;
+    earnings: z.ZodObject<{
+        l1_amps: z.ZodNumber;
+        l2_amps: z.ZodNumber;
+        total_amps: z.ZodNumber;
+        l1_count: z.ZodNumber;
+        l2_count: z.ZodNumber;
+    }, z.core.$strip>;
+    users: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            account: z.ZodString;
+            level: z.ZodEnum<{
+                L1: "L1";
+                L2: "L2";
+            }>;
+            referred_by: z.ZodNullable<z.ZodString>;
+            total_amps: z.ZodNumber;
+            affiliate_amps_earned: z.ZodNumber;
+            total_volume: z.ZodNumber;
+            active: z.ZodBoolean;
+        }, z.core.$strip>>;
+        total_count: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ReferralCodeValidation = z.infer<typeof ReferralCodeValidationSchema>;
+export type RedeemReferralResponse = z.infer<typeof RedeemReferralResponseSchema>;
+export type AccountReferral = z.infer<typeof AccountReferralSchema>;
+export type ReferrerStats = z.infer<typeof ReferrerStatsSchema>;
+export type UserReferral = z.infer<typeof UserReferralSchema>;
+export type UserReferralsResponse = z.infer<typeof UserReferralsResponseSchema>;
+export type AffiliateCode = z.infer<typeof AffiliateCodeSchema>;
+export type AffiliateCodesResponse = z.infer<typeof AffiliateCodesResponseSchema>;
+export type AffiliateReferredUser = z.infer<typeof AffiliateReferredUserSchema>;
+export type AffiliateEarningsBreakdown = z.infer<typeof AffiliateEarningsBreakdownSchema>;
+export type AffiliateEarningsResponse = z.infer<typeof AffiliateEarningsResponseSchema>;
+//# sourceMappingURL=referrals.types.d.ts.map

package/dist/read/referrals/referrals.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referrals.types.d.ts","sourceRoot":"","sources":["../../../src/read/referrals/referrals.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,WAAW,wBAAyB,SAAQ,eAAe,EAAE,UAAU;IAC3E,eAAe,EAAE,MAAM,CAAC;CACzB;AAGD,eAAO,MAAM,4BAA4B;;;;iBAIvC,CAAC;AAGH,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAC;AAGH,eAAO,MAAM,qBAAqB;;;;;;;iBAOhC,CAAC;AAGH,eAAO,MAAM,mBAAmB;;;;;;;iBAO9B,CAAC;AAMH,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AAGH,eAAO,MAAM,2BAA2B;;;;;;kBAA8B,CAAC;AAGvE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAS9B,CAAC;AAGH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;iBAIvC,CAAC;AAGH,eAAO,MAAM,2BAA2B;;;;;;;;;;;iBAQtC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;;iBAM3C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ1C,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAC1F,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/read/referrals/referrals.types.js

@@ -0,0 +1,85 @@
+import { z } from "zod/v4";
+// GET /api/v1/referrals/code/{code}
+export const ReferralCodeValidationSchema = z.object({
+    referral_code: z.string(),
+    is_valid: z.boolean(),
+    is_active: z.boolean(),
+});
+// POST /api/v1/referrals/redeem
+export const RedeemReferralResponseSchema = z.object({
+    referral_code: z.string(),
+    account: z.string(),
+});
+// GET /api/v1/referrals/account/{account}
+export const AccountReferralSchema = z.object({
+    account: z.string(),
+    referrer_account: z.string(),
+    referral_code: z.string(),
+    is_affiliate_referral: z.boolean(),
+    referred_at_ms: z.number(),
+    is_active: z.boolean(),
+});
+// GET /api/v1/referrals/stats/{account}
+export const ReferrerStatsSchema = z.object({
+    referrer_account: z.string(),
+    total_referrals: z.number(),
+    total_codes_created: z.number(),
+    is_affiliate: z.boolean(),
+    codes: z.array(z.string()),
+    volume_threshold_met: z.boolean(),
+});
+// GET /api/v1/affiliates/codes/{account}
+const ReferralCodeSourceSchema = z.enum(["admin", "auto", "predeposit", "unknown"]);
+// GET /api/v1/referrals/users
+export const UserReferralSchema = z.object({
+    account: z.string(),
+    referrer_account: z.string(),
+    referral_code: z.string(),
+    is_affiliate_referral: z.boolean(),
+    referred_at_ms: z.number(),
+});
+// GET /api/v1/referrals/users
+export const UserReferralsResponseSchema = z.array(UserReferralSchema);
+// GET /api/v1/affiliates/codes/{account}
+export const AffiliateCodeSchema = z.object({
+    referral_code: z.string(),
+    owner_account: z.string(),
+    max_usage: z.number(),
+    usage_count: z.number(),
+    is_active: z.boolean(),
+    is_affiliate: z.boolean(),
+    source: ReferralCodeSourceSchema,
+    created_at_ms: z.number(),
+});
+// GET /api/v1/affiliates/codes/{account}
+export const AffiliateCodesResponseSchema = z.object({
+    owner_account: z.string(),
+    codes: z.array(AffiliateCodeSchema),
+    volume_threshold_met: z.boolean(),
+});
+// GET /api/v1/affiliates/earnings/{account}
+export const AffiliateReferredUserSchema = z.object({
+    account: z.string(),
+    level: z.enum(["L1", "L2"]),
+    referred_by: z.string().nullable(),
+    total_amps: z.number(),
+    affiliate_amps_earned: z.number(),
+    total_volume: z.number(),
+    active: z.boolean(),
+});
+export const AffiliateEarningsBreakdownSchema = z.object({
+    l1_amps: z.number(),
+    l2_amps: z.number(),
+    total_amps: z.number(),
+    l1_count: z.number(),
+    l2_count: z.number(),
+});
+export const AffiliateEarningsResponseSchema = z.object({
+    affiliate_account: z.string(),
+    is_affiliate: z.boolean(),
+    earnings: AffiliateEarningsBreakdownSchema,
+    users: z.object({
+        items: z.array(AffiliateReferredUserSchema),
+        total_count: z.number(),
+    }),
+});

package/dist/read/streaks/streaks.reader.d.ts

@@ -0,0 +1,19 @@
+import { BaseReader } from "../base-reader";
+import { AccountStreaksRequestArgs } from "./streaks.types";
+export declare class StreaksReader extends BaseReader {
+    /**
+     * Get streak data for an owner including qualifying dates and grace days
+     * @param ownerAddr The owner address to get streak data for
+     * @returns The streak data with qualifying dates
+     */
+    getByOwner({ ownerAddr, fetchOptions }: AccountStreaksRequestArgs): Promise<{
+        owner: string;
+        currentStreak: number;
+        streakIpoints: number;
+        streakAmpsEstimate: number;
+        graceDaysAvailable: number;
+        graceDaysUsed: number;
+        qualifyingDates: string[];
+    }>;
+}
+//# sourceMappingURL=streaks.reader.d.ts.map

package/dist/read/streaks/streaks.reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaks.reader.d.ts","sourceRoot":"","sources":["../../../src/read/streaks/streaks.reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAwB,MAAM,iBAAiB,CAAC;AAElF,qBAAa,aAAc,SAAQ,UAAU;IAC3C;;;;OAIG;IACG,UAAU,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,yBAAyB;;;;;;;;;CAYxE"}