@raintree-technology/perps 0.1.0

package/dist/lib/network-model.js

@@ -0,0 +1,30 @@
+const INTENT_DEFAULTS = {
+    execution: "testnet",
+    data: "mainnet",
+    neutral: null,
+};
+export function resolveNetworkDecision(input) {
+    if (input.cliOverride) {
+        return {
+            network: input.cliOverride,
+            source: "cli-override",
+        };
+    }
+    if (input.exchangeOverride) {
+        return {
+            network: input.exchangeOverride,
+            source: "exchange-override",
+        };
+    }
+    const intentDefault = INTENT_DEFAULTS[input.intent];
+    if (intentDefault) {
+        return {
+            network: intentDefault,
+            source: "intent-default",
+        };
+    }
+    return {
+        network: input.fallbackNetwork ?? "mainnet",
+        source: "fallback",
+    };
+}

package/dist/lib/onboarding.d.ts

@@ -0,0 +1,133 @@
+import { type Address, type Hex } from "viem";
+export type SetupMode = "mainnet-data" | "testnet-execution" | "both";
+export type SetupChain = "evm" | "aptos" | "starknet";
+export type SetupExchange = "hyperliquid" | "decibel" | "aevo" | "orderly" | "paradex";
+export type FundingStatus = "ok" | "skipped" | "manual" | "error";
+export interface ManualFollowUp {
+    exchange: SetupExchange;
+    env: string[];
+    detail: string;
+}
+export interface OnboardingProfile {
+    mode: SetupMode;
+    chains: SetupChain[];
+    exchanges: SetupExchange[];
+    generatedAt: string;
+    credentials: {
+        hyperliquid?: {
+            privateKey: Hex;
+            walletAddress: Address;
+        };
+        decibel?: {
+            apiWalletPrivateKey: string;
+            apiWalletAddress: string;
+            apiBearerToken?: string;
+        };
+        aevo?: {
+            signingKey: Hex;
+            apiKey?: string;
+            apiSecret?: string;
+        };
+        orderly?: {
+            tradingSecret: Hex;
+            accountId?: string;
+            key?: string;
+            secret?: string;
+        };
+        paradex?: {
+            privateKey: string;
+            starkPublicKey: string;
+            accountAddress?: string;
+            ethereumAccount?: string;
+            apiBearerToken?: string;
+        };
+    };
+    wallets: {
+        evmAddress?: Address;
+        aptosAddress?: string;
+        starkPublicKey?: string;
+    };
+    manualFollowUps: ManualFollowUp[];
+}
+export interface OnboardingFundingOptions {
+    orderlyBrokerId?: string;
+    orderlyChainId?: number;
+    aptosFaucetJwt?: string;
+    aptosFaucetAmount?: number;
+}
+export interface OnboardingAuthOptions {
+    decibelBearerToken?: string;
+    aevoApiKey?: string;
+    aevoApiSecret?: string;
+    aevoAccountPrivateKey?: Hex;
+    aevoRestUrl?: string;
+    orderlyBrokerId?: string;
+    orderlyChainId?: number;
+    orderlyRestUrl?: string;
+    orderlyAccountId?: string;
+    orderlyKey?: string;
+    orderlySecret?: string;
+    paradexApiBearerToken?: string;
+    paradexAccountAddress?: string;
+    paradexEthereumAccount?: string;
+    paradexRestUrl?: string;
+}
+export interface FundingResult {
+    exchange: SetupExchange;
+    service: string;
+    status: FundingStatus;
+    detail: string;
+}
+export interface AuthResult {
+    exchange: SetupExchange;
+    service: string;
+    status: FundingStatus;
+    detail: string;
+}
+export type OnboardingStep = "plan" | "generate" | "fund" | "verify" | "report";
+export type OnboardingStepStatus = "pending" | "running" | "done" | "error";
+export interface OnboardingRunState {
+    id: string;
+    idempotencyKey: string;
+    mode: SetupMode;
+    exchanges: SetupExchange[];
+    updatedAt: string;
+    statusByStep: Record<OnboardingStep, OnboardingStepStatus>;
+    profile?: OnboardingProfile;
+    authResults?: AuthResult[];
+    fundingResults?: FundingResult[];
+    notes: string[];
+}
+export interface OnboardingRunResult {
+    profile: OnboardingProfile;
+    authResults: AuthResult[];
+    fundingResults: FundingResult[];
+    statePath: string;
+    state: OnboardingRunState;
+}
+export declare const ALL_SETUP_CHAINS: SetupChain[];
+export declare const ALL_SETUP_EXCHANGES: SetupExchange[];
+export declare const SETUP_MODES: SetupMode[];
+export declare function bootstrapOnboardingAuth(profile: OnboardingProfile, options?: OnboardingAuthOptions): Promise<AuthResult[]>;
+export declare function parseSetupMode(value: string): SetupMode;
+export declare function parseSetupChains(value: string): SetupChain[];
+export declare function parseSetupExchanges(value: string): SetupExchange[];
+export declare function resolveExchangesFromChains(chains: SetupChain[]): SetupExchange[];
+export declare function inferChainsFromExchanges(exchanges: SetupExchange[]): SetupChain[];
+export declare function createOnboardingProfile(args: {
+    mode: SetupMode;
+    exchanges: SetupExchange[];
+}): OnboardingProfile;
+export declare function buildOnboardingEnvFile(profile: OnboardingProfile): string;
+export declare function fundOnboardingWallets(profile: OnboardingProfile, options?: OnboardingFundingOptions): Promise<FundingResult[]>;
+export declare function runOnboardingStateMachine(args: {
+    mode: SetupMode;
+    exchanges: SetupExchange[];
+    shouldFund: boolean;
+    fundingOptions?: OnboardingFundingOptions;
+    shouldBootstrapAuth?: boolean;
+    authOptions?: OnboardingAuthOptions;
+    statePath?: string;
+    resume?: boolean;
+    fundingRetries?: number;
+}): Promise<OnboardingRunResult>;